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

转换代码很多是不是架构有问题

转换代码很多是不是架构有问题

当 DTO、领域对象和持久化对象被刻意分开后,项目里常会出现一批转换方法,看起来像“重复劳动”。真正要判断的不是代码行数,而是这些转换是否在保护模型边界,以及重复是否已经高到值得用工具治理。

学习目标

  • 判断显式模型转换何时是在保护边界,而不是无意义样板代码
  • 理解 DTO、领域对象与持久化对象之间为什么不应默认共用同一类型
  • 知道何时可以引入映射工具,并保留业务语义和依赖方向

转换多不等于设计坏

同一个“订单”在不同边界里承担的职责并不一样。接口 DTO 关心请求字段和协议兼容;领域对象关心业务不变量;持久化对象关心表结构、主键和存储细节。把三者合成一个类,代码会暂时变少,但任何一层字段变化都可能穿透到其他层。

因此,转换代码本身是一种隔离成本。它把“外部输入如何解释成业务含义”和“业务状态如何落到存储结构”明确写在边界处。只要转换逻辑集中、命名清楚、变化方向可控,这些代码通常是在换取更低的耦合,而不是架构失控。

DTO、领域对象与持久化对象的边界转换关系

用可运行示例看转换的价值

下面的 Java 17 示例故意保留三种模型。请求对象允许表达接口输入,领域对象在构造时校验数量,持久化对象则额外拥有数据库主键。转换类只负责跨边界搬运和解释数据。

java
public class ConversionBoundaryDemo {
    record CreateOrderRequest(String customerId, int quantity) {}

    record Order(String customerId, int quantity) {
        Order {
            if (customerId == null || customerId.isBlank()) {
                throw new IllegalArgumentException("customerId required");
            }
            if (quantity <= 0) {
                throw new IllegalArgumentException("quantity must be positive");
            }
        }
    }

    record OrderRow(long id, String customerId, int quantity) {}

    static final class OrderMapper {
        static Order toDomain(CreateOrderRequest request) {
            return new Order(request.customerId(), request.quantity());
        }

        static OrderRow toRow(long id, Order order) {
            return new OrderRow(id, order.customerId(), order.quantity());
        }
    }

    public static void main(String[] args) {
        CreateOrderRequest request = new CreateOrderRequest("C-100", 2);
        Order order = OrderMapper.toDomain(request);
        OrderRow row = OrderMapper.toRow(42L, order);

        System.out.println(order);
        System.out.println(row);
    }
}

预期输出

text
Order[customerId=C-100, quantity=2]
OrderRow[id=42, customerId=C-100, quantity=2]

这里的关键不是 OrderMapper 有几行,而是领域对象没有出现数据库主键生成规则,也没有为了接口兼容而接受无效数量。边界变化被限制在转换位置,核心业务规则仍留在领域模型内部。

什么时候该减少手写代码

如果大量转换只是名称和类型完全一致的机械复制,可以使用代码生成型映射工具减少样板代码,但应把工具限制在边界适配层。涉及状态计算、默认值、单位换算、权限裁剪或业务校验的转换,仍应显式表达,避免把业务含义藏进自动映射配置。

反过来,如果一个简单 CRUD 模块中的 DTO、领域模型和数据库记录长期完全同构,而且没有独立业务规则,强行拆成三套类型可能只会增加维护成本。此时可以合并部分模型,但应确认这是基于稳定边界做出的取舍,而不是为了消灭几行转换代码。

判断是否真的出现架构问题

转换代码值得治理,通常不是因为“多”,而是出现了更具体的信号:同一字段规则在多个 Mapper 中重复实现;转换类开始直接访问数据库或远程服务;领域规则被搬到转换层;模型每改一个字段就必须修改大量无关模块。

处理这些问题时,优先收敛转换入口、复用纯粹的值对象转换,并让每个 Mapper 只服务明确边界。工具可以降低机械复制成本,但不能替代边界设计;保留模型隔离,同时让重复保持可控,才是转换代码应达到的状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

转换代码很多是不是架构有问题

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

登录哪都通