Java 后端 / 系统课时
设计聚合与仓储边界
设计聚合与仓储边界
聚合设计的目标不是把有关联的对象全部装进一个大模型,而是确定一次业务事务必须保持一致的最小边界。本课将以订单场景为例,完成聚合根、仓储接口和跨聚合协作方式的设计,并给出可落地的 Spring Boot 代码结构。
学习目标
- 根据业务不变量识别聚合根与聚合边界
- 为聚合定义面向领域的仓储接口
- 使用应用服务协调跨聚合操作,避免直接耦合
从业务不变量划定聚合
聚合边界应从“哪些规则必须在一次事务中同时成立”出发,而不是从数据库外键或页面表单出发。以订单为例,“订单总金额必须等于订单项金额之和”“已取消订单不能继续增加商品”都要求订单与订单项在同一事务内保持一致,因此 Order 适合作为聚合根,OrderItem 只能通过 Order 修改。
客户余额、库存和订单虽然业务相关,但各自拥有独立生命周期和并发压力。若把它们放进同一聚合,一次下单就可能锁定大量数据,使模型难以扩展。更合理的做法是让订单、库存和客户分别成为聚合,由应用服务或领域事件完成协作。

实现聚合根
聚合根负责保护内部状态,不应暴露可任意修改的集合。下面是片段示例,需放入同一 Java 包并由应用服务或测试代码调用;它把新增订单项和取消订单都封装在 Order 内部,调用者无法绕过业务规则直接改写订单项。
package com.example.order.domain;
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.UUID;
public class Order {
private final UUID id;
private final List<OrderItem> items = new ArrayList<>();
private OrderStatus status = OrderStatus.CREATED;
public Order(UUID id) {
this.id = id;
}
public void addItem(UUID productId, int quantity, BigDecimal unitPrice) {
if (status == OrderStatus.CANCELLED) {
throw new IllegalStateException("已取消订单不能增加商品");
}
if (quantity <= 0 || unitPrice.signum() < 0) {
throw new IllegalArgumentException("数量和单价不合法");
}
items.add(new OrderItem(productId, quantity, unitPrice));
}
public void cancel() {
status = OrderStatus.CANCELLED;
}
public BigDecimal totalAmount() {
return items.stream()
.map(OrderItem::subtotal)
.reduce(BigDecimal.ZERO, BigDecimal::add);
}
public UUID id() {
return id;
}
public List<OrderItem> items() {
return Collections.unmodifiableList(items);
}
public OrderStatus status() {
return status;
}
}配套值对象和状态定义如下。
package com.example.order.domain;
import java.math.BigDecimal;
import java.util.UUID;
record OrderItem(UUID productId, int quantity, BigDecimal unitPrice) {
public BigDecimal subtotal() {
return unitPrice.multiply(BigDecimal.valueOf(quantity));
}
}
enum OrderStatus {
CREATED, CANCELLED
}预期结果:创建订单并加入两个单价为 10 元、数量分别为 2 和 1 的订单项后,totalAmount() 返回 30;订单取消后再次调用 addItem 会抛出 IllegalStateException。
定义仓储与跨聚合协作
仓储接口应表达领域需要的持久化能力,而不是暴露通用 CRUD。下面是片段示例,接口放在领域层,实现类放在基础设施层,从而让领域模型不依赖 JPA、MyBatis 或具体数据库。
package com.example.order.domain;
import java.util.Optional;
import java.util.UUID;
public interface OrderRepository {
Optional<Order> findById(UUID orderId);
void save(Order order);
}该接口的生效行为是:应用服务只能按领域语义加载和保存完整订单聚合,不能直接保存某个 OrderItem。验证时可在仓储实现的集成测试中保存订单,再按订单 ID 读取并断言订单项和状态完整恢复。
跨聚合操作不要在一个聚合根中直接调用另一个仓储。应用服务负责事务编排:先加载订单,执行领域行为,再保存订单;需要扣减库存时,可调用库存应用服务或发布领域事件。强一致性要求极高时,可以在同一应用事务中依次操作两个仓储,但必须评估锁竞争与失败回滚成本。以下同样是依赖仓储实现的片段示例。
package com.example.order.application;
import com.example.order.domain.Order;
import com.example.order.domain.OrderRepository;
import java.util.UUID;
public class CancelOrderService {
private final OrderRepository orderRepository;
public CancelOrderService(OrderRepository orderRepository) {
this.orderRepository = orderRepository;
}
public void cancel(UUID orderId) {
Order order = orderRepository.findById(orderId)
.orElseThrow(() -> new IllegalArgumentException("订单不存在"));
order.cancel();
orderRepository.save(order);
}
}预期结果:传入存在的订单 ID 时,订单状态变为 CANCELLED 并被仓储保存;传入不存在的 ID 时,抛出 IllegalArgumentException。实际 ID 可使用 <ID> 代替。
聚合应尽量小,但不能小到无法保护业务不变量。设计完成后,应确认外部对象只能持有聚合根 ID,不直接引用内部实体;一次命令只修改一个聚合;仓储以聚合根为单位加载和保存;跨聚合规则采用应用服务、领域事件或补偿机制实现。