從混亂到優雅:基於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 微服務框架,幫助我們輕鬆構建和管理微服務應用。 本框架不僅支持 Consul 服務註 ...
  • 先看一下效果吧: 如果不會寫動畫或者懶得寫動畫,就直接交給Blend來做吧; 其實Blend操作起來很簡單,有點類似於在操作PS,我們只需要設置關鍵幀,滑鼠點來點去就可以了,Blend會自動幫我們生成我們想要的動畫效果. 第一步:要創建一個空的WPF項目 第二步:右鍵我們的項目,在最下方有一個,在B ...
  • Prism:框架介紹與安裝 什麼是Prism? Prism是一個用於在 WPF、Xamarin Form、Uno 平臺和 WinUI 中構建鬆散耦合、可維護和可測試的 XAML 應用程式框架 Github https://github.com/PrismLibrary/Prism NuGet htt ...
  • 在WPF中,屏幕上的所有內容,都是通過畫筆(Brush)畫上去的。如按鈕的背景色,邊框,文本框的前景和形狀填充。藉助畫筆,可以繪製頁面上的所有UI對象。不同畫筆具有不同類型的輸出( 如:某些畫筆使用純色繪製區域,其他畫筆使用漸變、圖案、圖像或繪圖)。 ...
  • 前言 嗨,大家好!推薦一個基於 .NET 8 的高併發微服務電商系統,涵蓋了商品、訂單、會員、服務、財務等50多種實用功能。 項目不僅使用了 .NET 8 的最新特性,還集成了AutoFac、DotLiquid、HangFire、Nlog、Jwt、LayUIAdmin、SqlSugar、MySQL、 ...
  • 本文主要介紹攝像頭(相機)如何採集數據,用於類似攝像頭本地顯示軟體,以及流媒體數據傳輸場景如傳屏、視訊會議等。 攝像頭採集有多種方案,如AForge.NET、WPFMediaKit、OpenCvSharp、EmguCv、DirectShow.NET、MediaCaptre(UWP),網上一些文章以及 ...
  • 前言 Seal-Report 是一款.NET 開源報表工具,擁有 1.4K Star。它提供了一個完整的框架,使用 C# 編寫,最新的版本採用的是 .NET 8.0 。 它能夠高效地從各種資料庫或 NoSQL 數據源生成日常報表,並支持執行複雜的報表任務。 其簡單易用的安裝過程和直觀的設計界面,我們 ...
  • 背景需求: 系統需要對接到XXX官方的API,但因此官方對接以及管理都十分嚴格。而本人部門的系統中包含諸多子系統,系統間為了穩定,程式間多數固定Token+特殊驗證進行調用,且後期還要提供給其他兄弟部門系統共同調用。 原則上:每套系統都必須單獨接入到官方,但官方的接入複雜,還要官方指定機構認證的證書 ...
  • 本文介紹下電腦設備關機的情況下如何通過網路喚醒設備,之前電源S狀態 電腦Power電源狀態- 唐宋元明清2188 - 博客園 (cnblogs.com) 有介紹過遠程喚醒設備,後面這倆天瞭解多了點所以單獨加個隨筆 設備關機的情況下,使用網路喚醒的前提條件: 1. 被喚醒設備需要支持這WakeOnL ...
  • 前言 大家好,推薦一個.NET 8.0 為核心,結合前端 Vue 框架,實現了前後端完全分離的設計理念。它不僅提供了強大的基礎功能支持,如許可權管理、代碼生成器等,還通過採用主流技術和最佳實踐,顯著降低了開發難度,加快了項目交付速度。 如果你需要一個高效的開發解決方案,本框架能幫助大家輕鬆應對挑戰,實 ...