Java 后端 / 系统课时

设计聚合与仓储边界

设计聚合与仓储边界

聚合设计的目标不是把有关联的对象全部装进一个大模型,而是确定一次业务事务必须保持一致的最小边界。本课将以订单场景为例,完成聚合根、仓储接口和跨聚合协作方式的设计,并给出可落地的 Spring Boot 代码结构。

学习目标

  • 根据业务不变量识别聚合根与聚合边界
  • 为聚合定义面向领域的仓储接口
  • 使用应用服务协调跨聚合操作,避免直接耦合

从业务不变量划定聚合

聚合边界应从“哪些规则必须在一次事务中同时成立”出发,而不是从数据库外键或页面表单出发。以订单为例,“订单总金额必须等于订单项金额之和”“已取消订单不能继续增加商品”都要求订单与订单项在同一事务内保持一致,因此 Order 适合作为聚合根,OrderItem 只能通过 Order 修改。

客户余额、库存和订单虽然业务相关,但各自拥有独立生命周期和并发压力。若把它们放进同一聚合,一次下单就可能锁定大量数据,使模型难以扩展。更合理的做法是让订单、库存和客户分别成为聚合,由应用服务或领域事件完成协作。

订单、库存与客户的聚合边界

实现聚合根

聚合根负责保护内部状态,不应暴露可任意修改的集合。下面是片段示例,需放入同一 Java 包并由应用服务或测试代码调用;它把新增订单项和取消订单都封装在 Order 内部,调用者无法绕过业务规则直接改写订单项。

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

配套值对象和状态定义如下。

java
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 或具体数据库。

java
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 读取并断言订单项和状态完整恢复。

跨聚合操作不要在一个聚合根中直接调用另一个仓储。应用服务负责事务编排:先加载订单,执行领域行为,再保存订单;需要扣减库存时,可调用库存应用服务或发布领域事件。强一致性要求极高时,可以在同一应用事务中依次操作两个仓储,但必须评估锁竞争与失败回滚成本。以下同样是依赖仓储实现的片段示例。

java
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,不直接引用内部实体;一次命令只修改一个聚合;仓储以聚合根为单位加载和保存;跨聚合规则采用应用服务、领域事件或补偿机制实现。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计聚合与仓储边界

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

登录哪都通