3. 领域驱动设计（DDD）基础：实体、值对象、聚合、领域事件的核心概念

领域驱动设计（Domain-Driven Design，DDD）为微服务架构提供了最精准的“服务边界”划分依据。在 API 治理中，DDD 的战术模式直接决定了接口的粒度、聚合程度以及数据变更的传播方式。本节将深入剖析 DDD 的四大核心构造块：实体（Entity）、值对象（Value Object）、聚合（Aggregate）和领域事件（Domain Event），并阐明它们如何指导 API 拆分。

3.1 实体（Entity）：具有唯一标识的领域对象

实体是 DDD 中最基本的构造块，其核心特征是拥有一个唯一标识（Identity），并且该标识在其生命周期内保持不变。实体的属性可以变化，但标识决定了它是“谁”。

• 标识优先：两个实体即使所有属性都相同，只要标识不同，就是不同的对象。
• 可变性：实体的状态（属性）会随时间变化，例如“订单”的状态从“已创建”变为“已支付”。
• 生命周期：实体有明确的创建、变更和销毁过程。

实体示例（Java 伪代码）

public class Order {
    private OrderId orderId;  // 值对象作为标识
    private String customerName;
    private OrderStatus status;
    private Money totalAmount; // 值对象

    public Order(OrderId orderId, String customerName) {
        this.orderId = orderId;
        this.customerName = customerName;
        this.status = OrderStatus.CREATED;
    }

    public void pay() {
        // 业务逻辑：校验状态、更新金额等
        this.status = OrderStatus.PAID;
        // 触发领域事件
        DomainEventPublisher.publish(new OrderPaidEvent(this.orderId));
    }
}

3.2 值对象（Value Object）：描述性、不可变、无标识

值对象用于描述实体的属性或度量，它没有唯一标识，通过所有属性的值来定义相等性。值对象通常是不可变（Immutable）的，一旦创建就不能修改，需要变更时直接替换整个对象。

3.3 聚合（Aggregate）：一致性边界与事务单元

聚合是 DDD 中最关键的概念，它定义了一组强一致性边界。聚合由聚合根（Aggregate Root）实体和一组内部实体/值对象组成。外部对象只能通过聚合根来访问聚合内部的对象，从而保证数据的一致性和业务不变量的保护。

• 聚合根：聚合中唯一的实体，是外部访问的唯一入口。聚合根拥有全局唯一标识。
• 一致性边界：聚合内部的所有变更必须在一次事务中完成，保证最终一致性。
• 引用规则：聚合之间只能通过聚合根 ID 进行引用，不能直接持有内部对象的引用。

聚合示例：订单聚合

// 聚合根：Order
public class Order {
    private OrderId id;
    private List<OrderLineItem> items; // 内部实体
    private Money totalAmount;          // 值对象
    private ShippingAddress address;    // 值对象

    // 外部只能通过聚合根操作
    public void addItem(ProductId productId, int quantity, Money price) {
        // 业务校验：商品是否可添加、库存检查等
        this.items.add(new OrderLineItem(productId, quantity, price));
        this.totalAmount = this.totalAmount.add(price.multiply(quantity));
    }

    public void changeShippingAddress(ShippingAddress newAddress) {
        this.address = newAddress;
    }
}

// 内部实体：OrderLineItem（没有全局标识，只有本地标识）
public class OrderLineItem {
    private ProductId productId;
    private int quantity;
    private Money unitPrice;
}

3.4 领域事件（Domain Event）：解耦与最终一致性

领域事件是 DDD 中实现最终一致性和跨聚合通信的核心机制。它表示领域中发生的、业务人员关心的、有意义的事件。领域事件通常以过去时命名（如 OrderPaid、InventoryReserved），并包含事件发生时所需的上下文数据。

• 发布-订阅模式：聚合根在状态变更后发布事件，其他聚合或服务订阅并响应。
• 解耦：发布者不需要知道谁在监听，降低了聚合之间的耦合度。
• 最终一致性：跨聚合的事务可以通过事件驱动的方式实现最终一致，避免分布式事务。

领域事件示例

// 领域事件定义
public class OrderPaidEvent {
    private final OrderId orderId;
    private final Money paidAmount;
    private final Instant occurredOn;

    // 构造函数、getter 省略
}

// 在聚合根中发布事件
public class Order {
    // ... 其他代码
    public void pay(Money amount) {
        if (!this.totalAmount.equals(amount)) {
            throw new IllegalArgumentException("支付金额与订单总额不匹配");
        }
        this.status = OrderStatus.PAID;
        // 发布领域事件
        DomainEventPublisher.publish(new OrderPaidEvent(this.orderId, amount, Instant.now()));
    }
}

// 订阅者处理事件
public class InventoryService {
    @EventListener
    public void onOrderPaid(OrderPaidEvent event) {
        // 扣减库存（最终一致性）
        inventoryRepository.reserve(event.getOrderId());
    }
}

3.5 四大概念在 API 治理中的映射

理解 DDD 的四大核心概念后，我们需要将它们映射到实际的 API 设计决策中。下表总结了每个概念对应的 API 治理要点：

3.6 实战案例：订单系统的 DDD 建模与 API 拆分

以一个典型的电商订单系统为例，展示如何运用 DDD 概念进行 API 拆分：

1. 识别聚合：Order（订单）、Product（商品）、Customer（客户）、Payment（支付）各为一个独立聚合。
2. 定义聚合根：Order 聚合根为 Order 实体；Product 聚合根为 Product 实体。
3. 设计 API 端点：
   • POST /orders — 创建订单（聚合根操作）
   • POST /orders/{orderId}/items — 添加订单项（通过聚合根操作内部实体）
   • POST /orders/{orderId}/pay — 支付订单（触发领域事件）
4. 定义领域事件：
   • OrderCreated — 订单创建后通知库存预留
   • OrderPaid — 支付成功后通知发货服务
   • PaymentFailed — 支付失败后通知订单取消