架构与系统设计 / 系统课时
用仓储隔离持久化细节
用仓储隔离持久化细节
当领域模型直接调用 ORM、拼接 SQL 或按表字段组织对象时,业务规则会被数据库结构反向牵制。本节用“聚合根 + 仓储接口 + 基础设施适配器”的方式切开依赖,让领域层只表达订单语义,同时保留替换 JDBC、ORM 或测试内存实现的空间。
学习目标
- 能围绕聚合根定义最小仓储接口,而不是把数据访问方法堆成 DAO
- 能把表结构、ORM 实体和映射逻辑留在基础设施层
- 能判断查询职责何时属于仓储,何时应交给独立的读模型
仓储首先服务于聚合边界
仓储不是“所有表操作的统一入口”,而是为聚合提供类似集合的访问方式。以订单聚合为例,调用方通常只需要按 OrderId 取得完整聚合,以及保存已经通过业务规则校验的聚合。接口参数和返回值应使用领域对象,不暴露表名、列名、分页游标或 ORM 会话。
一个常见的最小接口只有 findById 与 save。如果接口里出现 updateOrderStatusColumn、findOrderRowBySql 之类方法,持久化模型已经泄漏到领域边界。反过来,也不要为了“通用”设计 Repository<T> 后再塞入大量与每个聚合无关的 CRUD 操作;仓储接口应跟随聚合真实需要生长。

用接口和映射层切断依赖
下面的示例把“表行”模拟成基础设施层内部的 OrderRow。领域对象 Order 不知道行结构,也不持有任何 ORM 注解;应用服务只依赖 OrderRepository。以后把内存实现替换成 JDBC 或 JPA 时,领域代码不需要修改。
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());
}
}预期输出
status=PAID, totalCents=29900这里真正被隔离的是依赖方向:Order 和 OrderRepository 表达领域语言,OrderRow 与映射代码表达持久化语言。数据库字段变化时,应优先修改适配器和映射;只有业务概念变化时,才需要修改领域模型。
区分聚合加载与查询报表
仓储适合“为了执行业务行为而加载聚合”。例如支付订单前,需要取得订单当前状态并执行 pay(),此时仓储返回聚合是合理的。若需求只是查询“本月各地区销售额前十名”,强行装配大量订单聚合既慢又没有业务价值,应该使用专门的查询服务或读模型直接返回 DTO。
同样,跨多个聚合的列表筛选也不应自动塞进某个仓储。先问调用方是否真的要修改这些聚合:如果只是展示、统计、搜索,通常让读模型面向查询结构设计更清晰;如果要执行业务规则,再通过仓储按聚合边界加载所需对象。
守住事务和实现边界
仓储通常以一个聚合为保存单位,事务边界也应优先与聚合一致。不要让领域对象接收 EntityManager、数据库连接或 Mapper;也不要让仓储返回“半个聚合”,再由上层猜测哪些关联尚未加载,否则业务规则会依赖持久化策略。
测试时可以注入内存仓储验证领域行为,生产环境再注入 JDBC、JPA 或其他实现。只要仓储接口保持领域语言,替换持久化技术就只是基础设施改动,而不是一次领域模型重写。