架构与系统设计 / 系统课时
DTO 应该出现在哪些地方
DTO 应该出现在哪些地方
DTO 不是“所有层之间都要加一层对象”,而是用于隔离边界契约。本节以创建用户为例,区分请求 DTO、应用 Command、领域对象和响应 DTO,说明它们各自在什么时候出现、为什么不能互相替代,以及一次请求应该如何穿过应用边界。
学习目标
- 区分请求 DTO、应用 Command、领域对象和响应 DTO 的职责
- 理解 DTO 应放在系统边界而不是领域模型内部随处传播
- 能设计一条从请求到领域对象再到响应 DTO 的清晰转换链路
DTO 主要解决边界契约问题
请求 DTO 描述客户端“能提交什么”,响应 DTO 描述客户端“能看到什么”。它们通常属于接口适配层,并服务于 HTTP、消息或 RPC 契约。应用 Command 则表达一个用例意图,例如“创建用户”,它可以脱离具体传输协议;领域对象负责执行业务规则,不应知道 JSON 字段名或数据库列。
| 对象 | 典型位置 | 核心职责 |
|---|---|---|
| Request DTO | 接口适配层 | 承接外部输入与基础格式校验 |
| Command | 应用层入口 | 表达一次用例调用所需的数据 |
| Domain Object | 领域层 | 维护业务规则和不变量 |
| Response DTO | 接口适配层 | 塑造稳定、最小化的对外输出 |

一次请求可以经过四种不同对象
下面的 Java 17 示例把 HTTP 请求 DTO 映射为应用 Command,再由应用服务创建领域对象,最后生成响应 DTO。示例没有依赖 Web 框架,因此可以直接编译运行,重点只放在边界转换。
public class Main {
record CreateUserRequest(String email, String displayName) {}
record CreateUserCommand(String email, String displayName) {}
record User(long id, String email, String displayName, String status) {}
record UserResponse(long id, String email, String displayName) {}
static final class UserApplicationService {
User handle(CreateUserCommand command) {
if (!command.email().contains("@")) {
throw new IllegalArgumentException("invalid email");
}
// 真实项目中 ID 通常来自仓储或专门的 ID 生成器。
return new User(1001L, command.email(), command.displayName(), "ACTIVE");
}
}
public static void main(String[] args) {
CreateUserRequest request =
new CreateUserRequest("alice@example.com", "Alice");
// 接口模型在应用边界转换为用例语言。
CreateUserCommand command =
new CreateUserCommand(request.email(), request.displayName());
User user = new UserApplicationService().handle(command);
// 返回边界只暴露客户端真正需要的字段。
UserResponse response =
new UserResponse(user.id(), user.email(), user.displayName());
System.out.println(response);
}
}预期输出
UserResponse[id=1001, email=alice@example.com, displayName=Alice]这里四种对象字段很相似,但职责不同。请求 DTO 以后可能增加验证码或协议字段;Command 可以保持“创建用户”用例所需的最小数据;领域对象拥有 status 等业务状态;响应 DTO 则故意不暴露内部状态。
Command 不是换了名字的 Request DTO
如果应用层直接接收 Web 请求对象,就会依赖接口协议。以后同一个创建用户用例从消息队列、批处理任务或后台管理入口触发时,应用服务仍被迫认识原来的 HTTP DTO。
Command 的价值在于把“协议输入”翻译成“用例语言”。简单系统里两者字段可以完全相同,但仍应把是否分离作为边界设计决定,而不是根据字段是否重复来决定。
DTO 不应在领域内部层层传递
领域服务、聚合和值对象之间应使用领域语言,而不是继续传 CreateUserRequest 或 UserResponse。否则校验注解、序列化字段、分页参数等接口细节会渗入领域层,领域规则也更难复用和测试。
实际项目不需要机械地为每一步创建新类型。边界足够简单时可以少做转换;但请求契约、用例语义、领域规则和响应形态一旦出现独立变化,就应拆开,让转换集中在接口适配层和应用层入口,而不是让 DTO 穿透整个系统。