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

订单规则怎样留在聚合内部

订单规则怎样留在聚合内部

订单聚合真正要保护的不是几个字段,而是“任何时刻都不能出现非法订单”。本节用一个可运行的 Java 示例,把金额计算、状态流转和明细修改都收进聚合内部,让外部代码只能调用合法的领域行为。

学习目标

  • 用构造方法建立订单初始不变量,避免半初始化对象进入系统
  • 用领域行为维护订单金额、状态与明细之间的一致性
  • 识别公开 Setter、直接暴露集合等破坏聚合边界的写法

聚合要保护的是不变量

假设订单有三条核心规则:新订单必须处于 DRAFT 状态且总金额为 0;总金额必须始终等于所有明细小计之和;订单确认后不能继续新增明细。这些规则彼此关联,如果应用服务分别修改 status、lines 和 totalAmount,任何漏写一步都可能产生非法状态。

因此,聚合根 Order 应成为唯一修改入口。外部可以说“新增明细”或“确认订单”,却不能直接说“把金额改成 100”或“把状态改成 CONFIRMED”。

订单聚合内部维护业务不变量

用构造方法建立合法起点

构造方法的职责不是把所有字段机械赋值,而是保证对象一出生就满足最基本规则。订单 ID 不能为空,状态固定从 DRAFT 开始,总金额固定为 0;调用方没有机会传入一个“刚创建却已经 CONFIRMED”的订单。

下面的示例还把明细自身的规则放进 OrderLine:商品编号不能为空、数量必须大于 0、单价不能为负数。这样错误数据不会先进入集合,再依赖其他代码补救。

java
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());
        }
    }
}

预期输出

text
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 就制造出非法订单。如果答案是否定的,金额、状态和明细这些规则才算真正留在了聚合内部。

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

目录与阅读设置

阅读设置

17

记录一个想法

订单规则怎样留在聚合内部

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

登录哪都通