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

用仓储隔离持久化细节

用仓储隔离持久化细节

当领域模型直接调用 ORM、拼接 SQL 或按表字段组织对象时,业务规则会被数据库结构反向牵制。本节用“聚合根 + 仓储接口 + 基础设施适配器”的方式切开依赖,让领域层只表达订单语义,同时保留替换 JDBC、ORM 或测试内存实现的空间。

学习目标

  • 能围绕聚合根定义最小仓储接口,而不是把数据访问方法堆成 DAO
  • 能把表结构、ORM 实体和映射逻辑留在基础设施层
  • 能判断查询职责何时属于仓储,何时应交给独立的读模型

仓储首先服务于聚合边界

仓储不是“所有表操作的统一入口”,而是为聚合提供类似集合的访问方式。以订单聚合为例,调用方通常只需要按 OrderId 取得完整聚合,以及保存已经通过业务规则校验的聚合。接口参数和返回值应使用领域对象,不暴露表名、列名、分页游标或 ORM 会话。

一个常见的最小接口只有 findById 与 save。如果接口里出现 updateOrderStatusColumn、findOrderRowBySql 之类方法,持久化模型已经泄漏到领域边界。反过来,也不要为了“通用”设计 Repository<T> 后再塞入大量与每个聚合无关的 CRUD 操作;仓储接口应跟随聚合真实需要生长。

仓储隔离领域模型与持久化实现

用接口和映射层切断依赖

下面的示例把“表行”模拟成基础设施层内部的 OrderRow。领域对象 Order 不知道行结构,也不持有任何 ORM 注解;应用服务只依赖 OrderRepository。以后把内存实现替换成 JDBC 或 JPA 时,领域代码不需要修改。

java
import java.util.HashMap;
import java.util.Map;
import java.util.Optional;

public class RepositoryDemo {
    record OrderId(String value) {}

    static final class Order {
        private final OrderId id;
        private final long totalCents;
        private String status;

        Order(OrderId id, long totalCents, String status) {
            if (totalCents <= 0) {
                throw new IllegalArgumentException("total must be positive");
            }
            this.id = id;
            this.totalCents = totalCents;
            this.status = status;
        }

        void pay() {
            if (!"CREATED".equals(status)) {
                throw new IllegalStateException("only created order can be paid");
            }
            status = "PAID";
        }

        OrderId id() { return id; }
        long totalCents() { return totalCents; }
        String status() { return status; }
    }

    // 领域侧接口只暴露聚合语义,不暴露表或 ORM API。
    interface OrderRepository {
        Optional<Order> findById(OrderId id);
        void save(Order order);
    }

    // 基础设施层内部结构,可替换为 JDBC 行映射或 ORM 实体。
    record OrderRow(String id, long totalCents, String status) {}

    static final class InMemoryOrderRepository implements OrderRepository {
        private final Map<String, OrderRow> table = new HashMap<>();

        public Optional<Order> findById(OrderId id) {
            // 映射发生在适配器内部,领域对象不感知存储结构。
            OrderRow row = table.get(id.value());
            return Optional.ofNullable(row)
                    .map(r -> new Order(new OrderId(r.id()), r.totalCents(), r.status()));
        }

        public void save(Order order) {
            table.put(
                    order.id().value(),
                    new OrderRow(order.id().value(), order.totalCents(), order.status())
            );
        }
    }

    public static void main(String[] args) {
        OrderRepository repository = new InMemoryOrderRepository();
        Order order = new Order(new OrderId("O-1001"), 29900, "CREATED");

        order.pay();
        repository.save(order);

        Order loaded = repository.findById(new OrderId("O-1001")).orElseThrow();
        System.out.println("status=" + loaded.status()
                + ", totalCents=" + loaded.totalCents());
    }
}

预期输出

text
status=PAID, totalCents=29900

这里真正被隔离的是依赖方向:Order 和 OrderRepository 表达领域语言,OrderRow 与映射代码表达持久化语言。数据库字段变化时,应优先修改适配器和映射;只有业务概念变化时,才需要修改领域模型。

区分聚合加载与查询报表

仓储适合“为了执行业务行为而加载聚合”。例如支付订单前,需要取得订单当前状态并执行 pay(),此时仓储返回聚合是合理的。若需求只是查询“本月各地区销售额前十名”,强行装配大量订单聚合既慢又没有业务价值,应该使用专门的查询服务或读模型直接返回 DTO。

同样,跨多个聚合的列表筛选也不应自动塞进某个仓储。先问调用方是否真的要修改这些聚合:如果只是展示、统计、搜索,通常让读模型面向查询结构设计更清晰;如果要执行业务规则,再通过仓储按聚合边界加载所需对象。

守住事务和实现边界

仓储通常以一个聚合为保存单位,事务边界也应优先与聚合一致。不要让领域对象接收 EntityManager、数据库连接或 Mapper;也不要让仓储返回“半个聚合”,再由上层猜测哪些关联尚未加载,否则业务规则会依赖持久化策略。

测试时可以注入内存仓储验证领域行为,生产环境再注入 JDBC、JPA 或其他实现。只要仓储接口保持领域语言,替换持久化技术就只是基础设施改动,而不是一次领域模型重写。

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

目录与阅读设置

阅读设置

17

记录一个想法

用仓储隔离持久化细节

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

登录哪都通