DDD 項目落地之充血模型實踐

一、背景

充血模型是 DDD 分層架構中實體設計的一種方案,可以使關注點聚焦於業務實現,可有效提升開發效率、提升可維護性;

二、DDD 項目落地整體調用關係

調用關係圖中的 Entity 爲實體,從進入領域服務(Domin)時開始使用,直到最後返回。

三、實體設計

充血模型是實體設計的一種方法,簡單來說,就是一種帶有具體行爲方法和聚合關聯關係的特殊實體;

關於實體設計,需要明白的關鍵詞爲:領域服務 -> 聚合 -> 聚合根 -> 實體 -> 貧血模型 -> 充血模型

聚合與聚合根:

聚合是一種關聯關係,而聚合根就是這個關係成立的基礎,沒有聚合根,這個聚合關係就無法成立;

舉個例子,存在 3 個實體:用戶、用戶組、用戶組關聯關係,這 3 個實體形成的關聯關係就是聚合,而用戶實體就是這個聚合中的聚合根;



實體:

定義在領域層,是領域層的重要元素,從領域劃分到工程實踐落地,都應該圍繞實體進行,DDD 中的實體和數據庫表不只是 1 對 1 關係,可能是 1 對多或者僅爲內存中的對象;

貧血模型:

實體不帶有任何行爲方法,也不帶有聚合關聯關係,作用基本相當於值對象(ValueObject),僅作爲值傳遞的對象,和傳統三層項目架構中的實體具有相同作用,不建議使用。補充說明:一般我們使用的 DTO 就可以被當做是值對象

充血模型:

實體中帶有具有行爲方法和聚合關聯關係,行爲方法是說 create、save、delete 等封裝了一類可以指代行爲的方法,比如在用戶實體對象中具有用戶組實體的引用,這樣當我們需要操作用戶組時,只通過用戶實體進行操作就可以。

工程實踐中,建議採用充血模型,好處是隱藏膠水代碼,提升代碼可讀性,使關注點聚焦於業務實現。

充血模型在實踐中的問題:

行爲代碼量過多,導致實體內部臃腫膨脹,難以閱讀,難以維護,對於這種問題,我們需要根據實體行爲的代碼量多少來採取不同的解決方案。

解決方案:

場景 1:行爲不會導致實體臃腫的情況下,在實體中完成行爲定義


public CooperateServicePackageConfig save() {    
    // 直接調用基礎設施層進行保存
    cooperateServicePackageConfigRepository.save(this);    
    return this;
}

場景 2:行爲導致實體臃腫的情況下,採用外部定義行爲的方式,核心思想是藉助其他類實現行爲代碼定義,將臃腫代碼外移,保留乾淨的實體行爲:

1)創建工具類,將某個實體中的行爲定義其中,實體負責調用該工具類


public CooperateServicePackageConfig save() {    
    // 將處理過程放在工具類中
    ServicePackageSaveUtils.save(this);   
    return this;
 }

2)創建新實體,將該實體的使用場景明確至某個細分行爲,比如一個聚合根(ExampleEntity)的保存可能涉及到 5 個實體的保存,那麼我們定義一個 ExampleSaveEntity 實體,專門用來處理該聚合下的保存行爲

實踐經驗:

1、關於 spring bean 注入:充血模型在實體中使用靜態注入方法實現。例:

private LabelInfoRepository labelInfoRepository = ApplicationContextUtils.getBean(LabelInfoRepository.class);

2、充血模型的實體序列化,排除非必要屬性,在一些redis對象緩存時可能會用到。例:

// 使用註解排除序列化屬性
@Getter(AccessLevel.NONE)
private LabelInfoRepository labelInfoRepository = ApplicationContextUtils.getBean(LabelInfoRepository.class);
// 使用註解排除序列化屬性
@JSONField(serialize = false)
private ServicePackageConfig servicePackageConfig;
// 使用註解排除序列化 get 方法
@Transient
@JSONField(serialize = false)
public static CooperateServicePackageRepositoryQuery getAllCodeQuery(Long contractId) {    
    CooperateServicePackageRepositoryQuery repositoryQuery = new CooperateServicePackageRepositoryQuery();    
    repositoryQuery.setContractIds(com.google.common.collect.Lists.newArrayList(contractId));    
    repositoryQuery.setCode(RightsPlatformConstants.CODE_ALL);   
     return repositoryQuery;
}

3、利用 Set 方法建立聚合綁定關係。例:


public void setServiceSkuInfos(List<ServiceSkuInfo> serviceSkuInfos) {    
    if (CollectionUtils.isEmpty(serviceSkuInfos)) 
    {        
        return;    
    }    
    this.serviceSkuInfos = serviceSkuInfos;    
    List<String> allSkuNoSet = serviceSkuInfos
                                .stream()
                                .map(one -> one.getSkuNo())
                                .collect(Collectors.toList());   
     String skuJoinStr = Joiner.on(GlobalConstant.SPLIT_CHAR).join(allSkuNoSet);    
     this.setSkuNoSet(skuJoinStr);
}
本文由 Readfog 進行 AMP 轉碼,版權歸原作者所有。
來源https://mp.weixin.qq.com/s/exMyshEbZUAVaQo9mjJ_Ug