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

对象转换应该放在哪一层

对象转换应该放在哪一层

对象转换放错位置,会让 Controller、应用服务和 Repository 彼此知道不该知道的模型。本篇沿着一次“创建订单”请求梳理转换边界:协议 DTO 在入口处收敛,领域实体由领域行为创建,PO 只在 Repository Implementation 内出现。

学习目标

  • 能判断 DTO、Command、Domain Entity 与 PO 的转换边界
  • 能区分 Controller、Assembler 与 Repository Implementation 的职责
  • 能避免领域层依赖 Web DTO 或持久化对象

按跨越的边界决定转换位置

转换代码应该放在“模型边界”的附近,而不是统一塞进某个 Mapper 工具类。HTTP 请求进入系统时,Controller 只负责协议适配;应用层使用 Command 或查询参数表达用例;领域层只接收领域可理解的值;持久化细节则由 Repository Implementation 隔离。

对象在分层架构中的转换路径

一个实用判断是:谁拥有目标模型,谁决定怎样构造它;谁跨越基础设施边界,谁负责屏蔽外部表示。 这样转换逻辑会自然分散到几个明确位置,而不是形成一个知道所有类型的“万能 Mapper”。

Controller 只做协议适配

Controller 可以接收 CreateOrderRequest,完成字段格式检查,并把它转换成应用层的 CreateOrderCommand。当字段映射稍复杂时,可以交给 RequestAssembler;但 Controller 不应直接创建 PO,也不应调用数据库 Mapper。

同样,返回给客户端的 OrderResponse 属于接口协议。若需要组合、格式化或隐藏字段,可以使用 ResponseAssembler 把应用层结果转换成响应 DTO,而不是让领域实体承担 JSON 展示职责。

Repository Implementation 隔离持久化对象

领域层中的 Repository 接口以 Domain Entity 或领域值为参数和返回值;基础设施层的 Repository Implementation 才知道 PO、ORM Mapper、SQL 或数据库字段。Domain Entity 与 PO 的双向转换也应留在这一侧,可以直接写在实现类中,也可以拆成仅服务于持久化的 Data Mapper。

下面的完整示例展示一条最小转换链路,重点是每种对象只出现在需要它的层次中。

java
public class Main {
    record CreateOrderRequest(long id, long amountCents) {}
    record CreateOrderCommand(long id, long amountCents) {}
    record OrderPO(long id, long amountCents, String status) {}

    static final class Order {
        private final long id;
        private final long amountCents;

        private Order(long id, long amountCents) {
            if (amountCents <= 0) {
                throw new IllegalArgumentException("amount must be positive");
            }
            this.id = id;
            this.amountCents = amountCents;
        }

        static Order create(long id, long amountCents) {
            return new Order(id, amountCents);
        }

        long id() {
            return id;
        }

        long amountCents() {
            return amountCents;
        }
    }

    interface OrderRepository {
        void save(Order order);
    }

    static final class OrderRepositoryImpl implements OrderRepository {
        @Override
        public void save(Order order) {
            // 持久化对象只在基础设施实现中出现。
            OrderPO po = new OrderPO(order.id(), order.amountCents(), "CREATED");
            System.out.println("insert order " + po.id() + ", status=" + po.status());
        }
    }

    static final class OrderApplicationService {
        private final OrderRepository repository;

        OrderApplicationService(OrderRepository repository) {
            this.repository = repository;
        }

        void create(CreateOrderCommand command) {
            Order order = Order.create(command.id(), command.amountCents());
            repository.save(order);
        }
    }

    static final class OrderController {
        private final OrderApplicationService service;

        OrderController(OrderApplicationService service) {
            this.service = service;
        }

        void create(CreateOrderRequest request) {
            // 入口只把协议 DTO 转成应用层命令。
            CreateOrderCommand command =
                new CreateOrderCommand(request.id(), request.amountCents());
            service.create(command);
        }
    }

    public static void main(String[] args) {
        OrderRepository repository = new OrderRepositoryImpl();
        OrderApplicationService service = new OrderApplicationService(repository);
        OrderController controller = new OrderController(service);

        controller.create(new CreateOrderRequest(1001L, 2599L));
    }
}

预期输出

text
insert order 1001, status=CREATED

示例中的应用服务没有把 Command “机械复制”成 Entity,而是调用 Order.create(),让领域对象自己验证金额不变量。这一点很重要:从应用输入进入领域模型时,真正的业务构造规则应由领域层掌握。

Assembler 不是万能转换中心

Assembler 适合处理边界两侧的表示差异,例如 Request DTO 与 Command、查询结果与 Response DTO。它可以减少 Controller 中的字段拼装,但不应该因此依赖 PO、ORM 实体或数据库 Mapper。

如果一个 Assembler 同时引用 Web DTO、Domain Entity、PO 和数据库客户端,它实际上把多层重新耦合在一起。此时更好的拆分是:接口侧 Assembler 管协议转换,持久化侧 Data Mapper 管 Entity 与 PO 转换,各自只知道相邻边界。

用依赖方向做最后检查

检查转换位置时,可以从依赖方向反推:领域层不能依赖 Web 或数据库类型;应用层可以依赖领域模型,但不应依赖 PO;Controller 不应越过应用层操作 Repository Implementation;Repository Implementation 可以依赖领域层定义的 Repository 接口,并在内部处理 PO。

当转换代码遵守这些边界时,接口字段变化通常只影响接口侧,表结构变化通常只影响基础设施侧,而业务规则仍然集中在领域模型中。

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

目录与阅读设置

阅读设置

17

记录一个想法

对象转换应该放在哪一层

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

登录哪都通