關於聚合根，領域事件的那點事---深入淺出理解DDD

京東雲開發者發表於2023-04-27
事件

作者：京東物流 趙勇萍

前言

最近有空會跟同事討論DDD架構的實踐落地的情況，但真實情況是，實際中對於領域驅動設計中的實體，值物件，聚合根，領域事件這些戰術類的實踐落地，每個人理解依然因人而異，大機率是因為這些概念還是有一些抽象，同時有有別於傳統的MVC架構開發。

在此，透過小demo的方式跟大家分享一下我對DDD中戰術層級的理解，算是拋磚引玉，該理解僅代表我個人在現階段的一個理解，也可能未來隨著業務經驗深入，還會有不同的理解。

既然說是小demo，還是要從業務場景出發，也就是我最熟知的電商業務場景說起。但是該篇文章裡， 我會簡化一些實際業務場景中的複雜度，透過最小顆粒度的demo，來反映實踐過程中的基本問題。

一個簡單的demo業務場景

話不多說，我先丟擲我自己假設的一個業務場景，就是我們熟知的電商網站下單購物的場景。具體細節如下：

1. 實體：

• 商品：擁有唯一標識、名稱、價格、庫存等屬性。

• 訂單：擁有唯一標識、下單時間、狀態等屬性。訂單包含多個訂單項。

2. 值物件：

• 地址：擁有省、市、區、詳細地址等屬性。

3. 領域事件：

• 訂單建立事件：當使用者下單時觸發該事件，包含訂單資訊、商品資訊等資料。

• 訂單支付事件：當使用者完成支付時觸發該事件，包含訂單資訊、支付金額等資料。

• 訂單發貨事件：當商家發貨時觸發該事件，包含訂單資訊、快遞公司、快遞單號等資料。

4. 聚合根：

• 商品聚合根：包含商品實體和相關的值物件，負責商品的建立、修改、查詢等操作。

• 訂單聚合根：包含訂單實體和相關的值物件，負責訂單的建立、修改、查詢等操作。

5. 對外介面服務：

• 建立訂單介面：使用者提交購買請求後，系統建立相應的訂單，並觸發訂單建立事件。

• 支付訂單介面：使用者完成支付後，系統更新訂單狀態，並觸發訂單支付事件。

• 發貨介面：商家發貨後，系統更新訂單狀態，並觸發訂單發貨事件。

• 查詢訂單介面：使用者可以根據訂單號等條件查詢自己的訂單資訊。

該demo中，商品和訂單是兩個核心領域概念，分別由對應的聚合根負責管理。同時，透過定義領域事件，實現了不同業務場景下的資料更新和通知。最後，對外提供了一組簡單的介面服務，方便系統的使用和擴充套件。

demo的java程式碼實現

好了，有了以上我們對業務場景的充分剖析，確定了子域，接下來我們該寫我們的程式碼。

  1. 商品實體類：
// 省略getter/setter方法
public class Product {
    private Long id;
    private String name;
    private BigDecimal price;
    private Integer stock;
}

2. 訂單實體類

// 省略getter/setter方法
public class Order {
    private Long id;
    private LocalDateTime createTime;
    private Integer status;
    private List orderItems;
}

3. 訂單項實體類

// 省略getter/setter方法
public class OrderItem {
    private Long id;
    private Product product;
    private Integer quantity;
    private BigDecimal price;
}

4. 地址值物件

// 省略getter/setter方法 
public class Address {
    private String province;
    private String city;
    private String district;
    private String detail;
}

5. 領域事件類

//訂單建立領域事件
public class OrderCreatedEvent {
    private Order order;
    private List orderItems;

    public OrderCreatedEvent(Order order, List orderItems) {
        this.order = order;
        this.orderItems = orderItems;
    }
}


//訂單支付領域事件
public class OrderPaidEvent {
    private Order order;
    private BigDecimal amount;

    public OrderPaidEvent(Order order, BigDecimal amount) {
        this.order = order;
        this.amount = amount;
    }
}

//訂單
public class OrderShippedEvent {
    private Order order;
    private String expressCompany;
    private String expressNo;

    public OrderShippedEvent(Order order, String expressCompany, String expressNo) {
        this.order = order;
        this.expressCompany = expressCompany;
        this.expressNo = expressNo;
    }
}

6. 商品聚合根

public class ProductAggregate {
    private ProductService productService;

    public void createProduct(Product product) {
        productService.create(product);
    }

    public void updateProduct(Product product) {
        productService.update(product);
    }

    public void deleteProduct(Long productId) {
        productService.delete(productId);
    }

    public Product getProductById(Long productId) {
        return productService.getById(productId);
    }
}

7. 訂單聚合根

public class OrderAggregate {
    private OrderService orderService;

    public void createOrder(Order order, List orderItems) {
        orderService.create(order);
        // 觸發訂單建立事件 
        DomainEventPublisher.publish(new OrderCreatedEvent(order, orderItems));
    }

    public void payOrder(Long orderId, BigDecimal amount) {
        orderService.pay(orderId, amount);
        // 觸發訂單支付事件
        DomainEventPublisher.publish(new OrderPaidEvent(orderService.getById(orderId), amount));
    }

    public void shipOrder(Long orderId, String expressCompany, String expressNo) {
        orderService.ship(orderId, expressCompany, expressNo);
        // 觸發訂單發貨事件 
        DomainEventPublisher.publish(new OrderShippedEvent(orderService.getById(orderId), expressCompany, expressNo));
    }

    public Order getOrderById(Long orderId) {
        return orderService.getById(orderId);
    }
}

總結

透過以上demo，對於實體和值物件，大家會很好理解，並且很直觀。但是， 我額外想重點解釋一下聚合根和領域事件的概念

1. 聚合根

從上面的demo可以看出，在合根類中，我們定義了商品和訂單的增、刪、查等操作，並且為訂單定義了建立訂單、支付訂單、發貨等業務邏輯程式碼。

聚合根是一個物件，它代表一組相關聯的物件的整體。在聚合根內部，可以包含多個實體物件和值物件。聚合根通常可以透過唯一識別符號來進行識別和訪問。它是整個聚合的管理者，負責維護聚合之內的一致性，並協調各個實體物件之間的關係。聚合根通常具有豐富的行為和操作，可以對聚合內部的物件進行復雜的操作。

所以說，真正的聚合根內的方法是基於充血模型封裝的，而不是僅僅是對物件的資料封裝。在聚合根中，物件不僅封裝了資料，還包含了相應的行為和業務邏輯。這意味著在一個聚合根中，物件可以自己處理自己的業務邏輯，而不需要外部的控制。就如同demo中所寫的那樣，訂單物件可能包含一些關於訂單處理和交付的方法，如確認訂單、取消訂單、發貨等。

2. 領域事件

領域事件是DDD中最重要的概念之一，他是解決子域之間耦合的重要手段，因為它們提供了一種將領域概念和業務語言轉化為程式碼的方法。當一個領域事件發生時，它會觸發一些操作，這些操作可能會更改系統的狀態，也可能會導致其他領域事件的發生。透過對領域事件進行建模，我們可以更好地瞭解業務過程並設計出更加符合實際需求的系統。

在DDD中，領域事件通常由三個部分組成：

  1. 事件名稱：這個名稱應該能夠簡潔明瞭地描述事件所代表的業務意義。

  2. 相關資料：這些資料包含了事件發生時與事件相關的所有資訊。例如，在一個電子商務系統中，如果訂單被提交，則訂單資訊以及買家和賣家的資訊都應該包括在該事件中。

  3. 傳送者和接收者：傳送者通常是觸發事件的物件，接收者則是事件處理的物件。

領域事件在DDD中有很多用途。例如，它們可以用來觸發其他業務流程、更新資料庫或通知其他子系統。它們還可以用於解決一些複雜的業務邏輯問題，例如併發、資料同步和錯誤處理等等。

總之，領域事件是DDD架構中非常重要的概念，它可以幫助我們更好地理解業務過程，設計出更加符合實際需求的系統，並提高系統的可維護性和可擴充套件性。

相關文章