從混亂到優雅:基於DDD的六邊形架構的代碼翻新指南

来源:https://www.cnblogs.com/jingdongkeji/archive/2023/11/13/17828840.html
-Advertisement-
Play Games

趁著雙十一備戰封板,終於又有一些時間可以梳理一下最近的心得。最近這半年跟同事討論比較多的是分層架構,然後就會遇到兩個觸及靈魂的問題,一個是如何做好分層架構,二是DDD在架構層面該如何落地。 ...


前言

趁著雙十一備戰封板,終於又有一些時間可以梳理一下最近的心得。

最近這半年跟同事討論比較多的是分層架構,然後就會遇到兩個觸及靈魂的問題,一個是如何做好分層架構,二是DDD在架構層面該如何落地。

為了說好分層,我們需要瞭解架構的意義。

良好的架構是為了保證一下兩點:

  • 治理應用複雜度,降低系統熵值;
  • 從隨心所欲的混亂狀態,走向井井有條的有序狀態。

比如,你去圖書館借閱書籍,對於紛繁雜亂的各類書籍,如果不能很好的管理和分類,必然會導致圖書館管理混亂,效率低下,使得圖書館不能正常運維。而分層架構的意義也在於此,當我們面對複雜的業務需求時,需要更好的規劃我們的包結構和依賴規約,可以更好的治理我們的服務,提升服務的可維護性,可擴展性,做到我們的架構以業務為核心,解耦外部依賴,分離業務複雜度和技術複雜度。

傳統分層架構有MVC,而這些年流行的六邊形架構,也是伴隨著DDD的興起而逐步被大家所接受。如果說DDD和六邊形架構的關係,他倆屬於不同層級的概念,DDD更偏向方法論,註重領域建模和業務邏輯的設計,強調將業務需求和領域知識轉化為軟體設計;而六邊形架構更註重系統的整體架構和模塊化設計,強調分離內部和外部系統的交互。他們倆的結合是一種非常好的實踐經驗, DDD中的領域模型是核心,其他層(如應用層、基礎設施層)依賴於領域模型;而六邊形架構正好為DDD提供了一種非常好的分層落地。

淺聊DDD落地

對於DDD,並沒有一種所謂的框架或者腳手架能夠對應,其根本原因在於,DDD其實是一種方法論,而非所謂的框架,它給我們提供了一種應對業務複雜度時的方法:

  • 通過架構設計來分離業務複雜度和技術複雜度;
  • 通過限界上下文去做到分而治之,將大系統拆解為若幹個高內聚低耦合的子域;
  • 通過面向對象的設計模式,將業務子域的知識進行抽象。

總結一下:

  1. DDD的戰略建模註重子域的劃分和限界上下文的定義。對應到落地就是包的拆解, 以及包之間的依賴和組合關係。
  2. 而DDD的戰術建模主要關註的是構造塊和柔性設計。構造塊就是我們常說的,類,對象,組合。而柔性設計就是我們面向對象的設計原則,得到一個高內聚低耦合的系統。所以說,DDD的戰術建模落地,一定伴隨著開發人員對設計模式的深刻理解和應用。

六邊形分層架構

1. App層

應用層是DDD中的頂層,負責協調和組織領域對象的交互。它接收來自用戶界面或外部系統的請求,並將其轉發給領域層進行處理。應用層負責定義應用的用例(Use Cases),處理事務邊界和協調領域對象的操作。它不包含業務邏輯,而是將請求轉化為領域對象的操作。應用層還可以包含獲取輸入,組裝上下文,參數校驗,異常定義,發送事件通知等。

2. Domain層

主要是封裝了核心業務邏輯,並通過領域服務(Domain Service)和領域對象(Domain Entity)的方法對App層提供業務實體和業務邏輯計算。領域是應用的核心,不依賴任何其他層次。同時領域層會有一個facade層,當領域服務對外部有調用依賴時,通過定義facade介面實現控制反轉。

3. Adapter層

負責與外部系統進行或者服務進行適配和集成,包括通信,數據緩存,介面適配等功能。

此外強調, RPC consumer調用放在適配器層。適配器層專註於與外部系統的集成和適配,將外部系統的介面和數據格式轉換為應用程式可以理解和處理的形式。將RPC調用放在適配器層可以更好地將與外部系統相關的技術細節與應用程式的業務邏輯和領域對象進行解耦,提高應用程式的可擴展性和可維護性。

對於所有出站適配層,都需要通過實現facade介面實現控制反轉。

4. 基礎設施層

負責提供支持應用程式運行的基礎設施,包括與具體技術相關的實現。基礎設施層通常包括與資料庫、消息隊列、緩存、外部服務等進行交互的代碼,以及一些通用的工具類和配置,也包括filter等實現。

基礎設施層和適配器層之間的關係是:

  1. 基礎設施層提供了與具體技術相關的實現,例如資料庫訪問、消息隊列連接、緩存操作等。適配器層可以使用基礎設施層提供的功能來與外部系統進行交互。
  2. 適配器層通過適配器模式或類似的機制,將外部系統的介面和數據格式轉換為應用程式可以理解和處理的形式。適配器層還負責將應用程式的請求轉發給基礎設施層進行具體的操作。
  3. 基礎設施層和適配器層一起工作,使得應用程式能夠與外部系統進行集成,並且將與外部系統相關的技術細節與應用程式的業務邏輯和領域對象進行解耦。這樣可以實現應用程式的可擴展性、可維護性和可測試性。

對於一些無複雜邏輯的,也可以直接讓上游掉基礎設施層,不必一定通過Adapter層。

腳手架的落地實踐

以上主要是理論介紹,基於以上的說明,在實踐中,我搭建了兩套分層架構的java腳手架。具體來說分為單module版本和多module版本。對於微服務系統來說,如果你的每個服務業務複雜度不高,建議使用單module版本;如果你是個複雜業務場景的單體應用,建議採用多module版本。

1. 單module腳手架

--root
    --application: 應用層是程式的入口,整合和組合domain提供的能力。
        --rpc: JSF provider對外提供的介面實現
        --controller: springMVC提供的controller
        --listener: MQ消息監聽器
        --task: 調度任務
        --translate: 將內部的BO映射為外部的VO/Entity
        --model: VO對象
    --adapter: 適配器層
       --rpc: JSF consumer,外部服務
       --mq: 消息隊列sender模塊
       --translate: 將外部數據結構映射為內部的DTO/BO
    --domain: 領域層
       --service: 領域服務可以按照自己情況靈活設計
       --facotry: 工廠
       --event/command: 事件驅動
       --model: 對象和實體
       --translate: 對象實體映射轉換
    --infrastructure:
       --repository: 持久化層,包括db模型,sql讀寫等
       --cache: Redis緩存讀寫
       --producer: MQ消息生成,即發送MQ消息。
       --config: 配置信息,例如ducc配置、資料庫、緩存配置等
       --translate: 將存儲層的數據結構PO映射為內部的BO
       --utils: 工具集合
    --common: 公共層
       --exception: 主要分為業務異常和系統異常。系統異常需要研發處理。業務異常需要具備監控能力。
       --utils: 工具類
       --enums: 枚舉類
       --common: 全局公共常量池
    --worker: 非同步服務
    --client: JSF SDK


maven私服拉取腳本如下:

單module版本maven私服拉取腳本如下:

mvn archetype:generate \
            -DarchetypeGroupId=com.jd.magnus \
            -DarchetypeArtifactId=magnus-single-archetype \
            -DarchetypeVersion=1.0.0-SNAPSHOT \
            -DinteractiveMode=false \
            -DarchetypeCatalog=remote \
            -Dversion=1.0.0-SNAPSHOT \
            -DgroupId=com.jdl.sps \
            -DartifactId=bff-single-demo1




2. 多module腳手架

此處有一個建議,在多module版本下,因為是複雜單體應用,所以建議內部進行拆包處理。每層內也可以基於不同領域場景也可以進行拆包操作,每個場景下層級結構是一樣的。如下圖舉例,其中app層中分別有兩個業務場景,包括商品和訂單:

多module版本的maven私服拉取腳本如下:

mvn archetype:generate \
            -DarchetypeGroupId=com.jd.magnus \
            -DarchetypeArtifactId=magnus-multi-ddd-archetype \
            -DarchetypeVersion=1.0.0-SNAPSHOT \
            -DinteractiveMode=false \
            -DarchetypeCatalog=remote \
            -Dversion=1.0.0-SNAPSHOT \
            -DgroupId=com.jdl.sps \
            -DartifactId=bff-demo1




小結

本框架是結合了DDD思想和六邊形架構思想,但腳手架不會限制大家能力和發揮。

如果你精通DDD,你可以在domain層採用標準的充血模型和子域拆分模式編寫你的代碼; 如果你精通MVC,該框架也可以簡化為大家熟悉的MVC開發模式。對於model的處理,也可靈活應對,在不影響整體代碼架構的情況下,允許不過度設計及對象多度封裝,鼓勵敏捷迭代和定期重構。

但有一個核心思想需要謹記:

我們儘量保證我們的代碼開發符合開閉原則,能夠通過增加類和方法的方式實現新功能迭代,儘量就要避免頻繁修改某個方法或者某個類,包與包之間要保證高內聚,低耦合。因為DDD思想的核心就是子域的拆分和對設計模式的合理運用。

作者:京東物流 趙勇萍

來源:京東雲開發者社區 自猿其說 Tech 轉載請註明來源


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 本文旨在探討火山引擎 DataLeap 在處理計算治理過程中所面臨的問題及其解決方案,並展示這些解決方案帶來的實際收益。主要內容包括:探討面臨的痛點和挑戰、提供自動化的解決方案、分析實踐效果和收益、提出結論和未來展望。 ...
  • 全局鎖 全局鎖是對整個資料庫實例加鎖,整個庫處於只讀狀態。 flush tables with read lock 適用場景 全局鎖適用於做全庫邏輯備份,但是整個庫處於只讀狀態,在備份期間,所有的更新操作、DDL將會被阻塞,會對業務產生影響。 single-transaction mysqldump ...
  • 前言 最近有需求,需把Unity軟體發佈到android平臺後開機啟動應用,在網上查了很多資料,現整理如下 Unity部分 新建項目,平臺設置為android tips: 需要勾選Export Project以便於導入Android Studio ,使用Unity版本為2021.3.32f1 And ...
  • 項目代碼同步至碼雲 weiz-vue3-template 關於vite的詳細配置可查看 vite官方文檔,本文簡單介紹vite的常用配置。 初始內容 項目初建後,vite.config.ts 的預設內容如下: import { defineConfig } from 'vite' import vu ...
  • 這裡給大家分享我在網上總結出來的一些知識,希望對大家有所幫助 前端“三清” 在前端開發中,我們經常聽到關於“三清”的說法,即 window、document、Object。這三者分別代表了 BOM(瀏覽器對象模型)、DOM(文檔對象模型)以及 JS 的頂層對象。在這個體系中,我們通過 JavaScr ...
  • 舉例:要屏蔽“Missing trailing comma”或“comma-dangle”警告,你可以使用ESLint的配置選項來設置規則。下麵是一些方法,你可以根據自己的需求選擇其中一種(這裡只是舉例,其他警告處理方法相同) 方法1:在代碼中添加註釋來禁用規則 在你希望屏蔽警告的代碼行的上方添加如 ...
  • 一、創建Date對象 var dateObj=new Date(); var now = Date.now() 當前時間 二、Date方法 1、將日期轉為字元串 toLocaleString() toLocaleDateString() toLocaleTimeString() 2、獲取年、月、日、 ...
  • 本文介紹了結構型設計模式中的代理設計模式,講解了靜態代理、JDK的動態代理和cglib的動態代理,並用代碼進行演示。 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...