架构与系统设计 / 系统课时

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 接口适配层 塑造稳定、最小化的对外输出

DTO、Command 与领域对象的转换链路

一次请求可以经过四种不同对象

下面的 Java 17 示例把 HTTP 请求 DTO 映射为应用 Command,再由应用服务创建领域对象,最后生成响应 DTO。示例没有依赖 Web 框架,因此可以直接编译运行,重点只放在边界转换。

java
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);
    }
}

预期输出

text
UserResponse[id=1001, email=alice@example.com, displayName=Alice]

这里四种对象字段很相似,但职责不同。请求 DTO 以后可能增加验证码或协议字段;Command 可以保持“创建用户”用例所需的最小数据;领域对象拥有 status 等业务状态;响应 DTO 则故意不暴露内部状态。

Command 不是换了名字的 Request DTO

如果应用层直接接收 Web 请求对象,就会依赖接口协议。以后同一个创建用户用例从消息队列、批处理任务或后台管理入口触发时,应用服务仍被迫认识原来的 HTTP DTO。

Command 的价值在于把“协议输入”翻译成“用例语言”。简单系统里两者字段可以完全相同,但仍应把是否分离作为边界设计决定,而不是根据字段是否重复来决定。

DTO 不应在领域内部层层传递

领域服务、聚合和值对象之间应使用领域语言,而不是继续传 CreateUserRequest 或 UserResponse。否则校验注解、序列化字段、分页参数等接口细节会渗入领域层,领域规则也更难复用和测试。

实际项目不需要机械地为每一步创建新类型。边界足够简单时可以少做转换;但请求契约、用例语义、领域规则和响应形态一旦出现独立变化,就应拆开,让转换集中在接口适配层和应用层入口,而不是让 DTO 穿透整个系统。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

DTO 应该出现在哪些地方

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通