架构与系统设计 / 系统课时
订单规则怎样留在聚合内部
订单规则怎样留在聚合内部
订单聚合真正要保护的不是几个字段,而是“任何时刻都不能出现非法订单”。本节用一个可运行的 Java 示例,把金额计算、状态流转和明细修改都收进聚合内部,让外部代码只能调用合法的领域行为。
学习目标
- 用构造方法建立订单初始不变量,避免半初始化对象进入系统
- 用领域行为维护订单金额、状态与明细之间的一致性
- 识别公开 Setter、直接暴露集合等破坏聚合边界的写法
聚合要保护的是不变量
假设订单有三条核心规则:新订单必须处于 DRAFT 状态且总金额为 0;总金额必须始终等于所有明细小计之和;订单确认后不能继续新增明细。这些规则彼此关联,如果应用服务分别修改 status、lines 和 totalAmount,任何漏写一步都可能产生非法状态。
因此,聚合根 Order 应成为唯一修改入口。外部可以说“新增明细”或“确认订单”,却不能直接说“把金额改成 100”或“把状态改成 CONFIRMED”。

用构造方法建立合法起点
构造方法的职责不是把所有字段机械赋值,而是保证对象一出生就满足最基本规则。订单 ID 不能为空,状态固定从 DRAFT 开始,总金额固定为 0;调用方没有机会传入一个“刚创建却已经 CONFIRMED”的订单。
下面的示例还把明细自身的规则放进 OrderLine:商品编号不能为空、数量必须大于 0、单价不能为负数。这样错误数据不会先进入集合,再依赖其他代码补救。
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
public class Main {
enum OrderStatus {
DRAFT, CONFIRMED
}
record OrderLine(String sku, int quantity, BigDecimal unitPrice) {
OrderLine {
Objects.requireNonNull(unitPrice, "unitPrice");
if (sku == null || sku.isBlank()) {
throw new IllegalArgumentException("sku is required");
}
if (quantity <= 0) {
throw new IllegalArgumentException("quantity must be positive");
}
if (unitPrice.signum() < 0) {
throw new IllegalArgumentException("unitPrice cannot be negative");
}
}
BigDecimal subtotal() {
return unitPrice.multiply(BigDecimal.valueOf(quantity));
}
}
static final class Order {
private final String id;
private final List<OrderLine> lines = new ArrayList<>();
private OrderStatus status;
private BigDecimal totalAmount;
Order(String id) {
if (id == null || id.isBlank()) {
throw new IllegalArgumentException("id is required");
}
this.id = id;
this.status = OrderStatus.DRAFT;
this.totalAmount = BigDecimal.ZERO;
}
void addLine(String sku, int quantity, BigDecimal unitPrice) {
ensureDraft();
lines.add(new OrderLine(sku, quantity, unitPrice));
recalculateTotal();
}
void confirm() {
ensureDraft();
if (lines.isEmpty()) {
throw new IllegalStateException("empty order cannot be confirmed");
}
status = OrderStatus.CONFIRMED;
}
private void recalculateTotal() {
totalAmount = lines.stream()
.map(OrderLine::subtotal)
.reduce(BigDecimal.ZERO, BigDecimal::add);
}
private void ensureDraft() {
if (status != OrderStatus.DRAFT) {
throw new IllegalStateException("confirmed order cannot be changed");
}
}
int lineCount() {
return lines.size();
}
BigDecimal totalAmount() {
return totalAmount;
}
OrderStatus status() {
return status;
}
}
public static void main(String[] args) {
Order order = new Order("O-1001");
order.addLine("BOOK", 2, new BigDecimal("19.90"));
order.addLine("PEN", 1, new BigDecimal("10.00"));
System.out.printf("lines=%d, total=%s, status=%s%n",
order.lineCount(), order.totalAmount(), order.status());
order.confirm();
System.out.println("confirmed=" + order.status());
try {
order.addLine("NOTE", 1, new BigDecimal("5.00"));
} catch (IllegalStateException e) {
System.out.println("rejected=" + e.getMessage());
}
}
}预期输出
lines=2, total=49.80, status=DRAFT
confirmed=CONFIRMED
rejected=confirmed order cannot be changed不要把规则拆回应用服务
如果 Order 提供 setStatus、setTotalAmount 和可修改的 getLines(),应用服务就必须记住正确的修改顺序,还可能绕过校验。规则一旦分散到多个调用方,聚合就只剩数据容器,无法保证自身始终合法。
更稳妥的做法是让应用服务表达用例,让聚合表达业务动作。例如应用服务负责加载订单、调用 addLine 或 confirm,再通过 Repository 保存;“能不能加”“金额怎么算”“什么时候能确认”仍由聚合判断。
为持久化留出受控入口
从数据库恢复聚合时,同样不能破坏不变量。实际项目通常会提供专门的重建工厂、包级构造方法或 ORM 映射策略,使“创建新订单”和“从持久化状态恢复订单”成为两条明确路径,而不是为了 ORM 方便就把所有字段改成公开可写。
判断聚合设计是否到位,可以看一个简单信号:调用方是否能够只凭公开 API 就制造出非法订单。如果答案是否定的,金额、状态和明细这些规则才算真正留在了聚合内部。