如何設計分層架構和交互介面 API ?

来源:https://www.cnblogs.com/itlaobingge/archive/2020/03/14/12490470.html
-Advertisement-
Play Games

在「 如何建立架構師的立體化思維? 」這篇文章中,老兵哥 跟大家一起聊到架構設計涉及業務、技術、系統和時間等幾個維度,也知道從技術維度可以將應用分成七層,那具體怎麼做呢?今天我們繼續來聊聊分層架構的設計流程,以及介面設計方法等內容。 ...


架構設計流程

在「 如何建立架構師的立體化思維? 」這篇文章中,老兵哥 跟大家一起聊到架構設計涉及業務、技術、系統和時間等幾個維度,也知道從技術維度可以將應用分成七層,那具體怎麼做呢?今天我們繼續來聊聊分層架構的設計流程,以及介面設計方法等內容。通常,我們可以將分層架構的設計流程分解為下列 4 個步驟:

  1. 第一步,結合現實情況,將系統劃分成多個層次。
  2. 第二步,確定層與層之間的關係,梳理出層與層之間的交互介面。
  3. 第三步,將功能相近的介面劃歸到一個模塊,確保模塊高內聚,對外低耦合。
  4. 第四步,在此基礎上進一步明晰介面的參數列表。

僅僅四個步驟就完成了架構設計嗎?這會不會太簡單空洞了呢?各位看官,不要著急,請聽蔡老師慢慢道來,每個步驟都有極具可操作性的方法及工具。

5 架構設計流程

層次的切分方法

面對一個龐然大物,你該如何下手呢?不用擔心,這已經給你準備了庖丁解牛的方法,輕輕鬆松把一個複雜的大系統變得可以掌控了。

  1. 第一刀:按照這套方法論來進行架構設計,最理想的情況是將X軸切分成七層。而第一刀應該先切在業務和領域之間,即通過API把兩邊解耦。交互和業務跟用戶關聯度高,經常隨需求變化而改動,而領域和資源相對比較穩定。
  2. 第二刀:考慮到要完成某些業務功能,系統可能需要調用外部系統協同完成,為了保證領域層相對穩定,我們需要隔離外部系統或數據持久層變化帶來的影響,那第二刀應該切在領域和資源之間。
  3. 第三刀:考慮到同樣的一個業務可能會有多套界面,例如有Web版、桌面版、移動版等,為了提高重用,隔離變更,那接下來要把交互和業務切開。

通過上面這溫柔的三刀,我們就可以把一個大塊頭切分成七個層次。

介面的設計方法

在確定分層之後,我們可以把每個業務需求的交互時序圖畫出來,而分層就是交互時序圖的主角。這時候我們就可以清晰的找出層與層之間的交互介面,以及可以初步確定每個介面的參數列表。

6 業務交互時序圖

考慮到API、領域模型介面、SPI是最為關鍵的介面,那良好的設計就顯得更為重要。那如何能夠設計出良好的介面呢?在這點上,蔡老師也有非常豐富的經驗可以分享:

 

7 介面設計流程圖

  1. 找出領域對象:通過多輪領域訪談,與業務專家一起分析出領域對象。另外,也可以通過研究外部介面及數據字典來明晰領域對象,反過來也可以豐富外部介面和數據字典。
  2. 設計領域模型、資源模型、數據模型:在挖掘領域對象的過程中,我們就可以開始設計領域模型了,確定領域對象之間的關聯關係。當關聯關係逐步清晰之後,我們還可以根據關聯關係的密集程度對領域對象的組織方式做一些調整,找出核心的領域對象集合,其他領域對象可以歸類到圍繞核心領域對象集合的衛星集合裡面。通過多輪調整,我們可以得到一個能夠映射業務、關係簡化的領域模型。然後兵分兩路啟動資源模型和數據模型的設計工作。上述三個模型之間的關係及區別,請參見下文。
  3. 設計領域模型介面、APISPI、資料庫:在設計領域模型介面時,我們要儘量做到不多不少,這些介面都是對外提供服務所必須的,也是全面的,並且粒度要細。在設計API時,我們要考慮內外客戶的需求和特點,做到方便易用,可以參考RESTful API設計相關的資料。在設計SPI時,我們要儘量隔離資源層對領域層的影響。

在完成上述工作之後,我們就可以進入實施階段,開始啟動代理層、核心層和服務層的代碼設計工作。另外,如果是對線上已有系統進行升級,那還要開始制定數據的遷移計劃。

三個模型之間的關係及區別

  1. 領域模型,映射特定業務領域當中核心領域對象及其關聯關係,這些對象及關係的存在都是完成業務規則所必須的,甚至是法律法規等明文要求的,不會輕易變動。
  2. 資源模型,基於領域模型,從為內外客戶提供服務的角度分析定義出來的,包含了資源對象及其關聯關係。根據內外客戶的特點及需求,我們可以調整資源模型中的內容。
  3. 數據模型,基於領域模型,從存儲(持久化或緩存)信息的角度分析定義出來的,包含數據對象及其關聯關係。根據存儲載體的特點及需求,我們可以調整數據模型中的內容。

先分享到這裡,堅持原創不易,如果你覺得有價值,麻煩動動手指點個 「」,老兵哥會更有動力。另外,我還會持續分享職業規劃、應聘面試、技能提升、影響力打造等經驗,關註 「 IT老兵哥 」,賦能程式人生

近期文章索引:


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

-Advertisement-
Play Games
更多相關文章
  • 前提:父容器設置了display:flex 或 inline-flex order 項目的排列順序 預設是0,數字越小,排在越前面 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" ...
  • 前端學習一段時間後,尤其是工作2-3年的小伙伴們在面試中都會害怕被問到webpack,我也害怕,每次都是臨時抱佛腳,雖然自己會簡單的配置webpack但是對webpack的原理還是一知半解,無意中看到這篇文章寫的還不錯,所以轉發過來,也方便自己學習和記錄。 const path = require( ...
  • box-sizing 在pc端一般使用預設值 content-box 在移動端一般使用 border-box <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="w ...
  • 物理像素=設備像素 css像素=邏輯像素=設備獨立像素=實際開發中使用的像素 .box{ width:200px; height:100px; } 設備像素比 dpr = 設備像素 / css像素 (縮放比為1的情況) dpr 描述的是單方向,因此當dpr=2,意味著一個css像素由2x2個物理像素 ...
  • 在 HTML 中,某些字元是預留的。在 HTML 中不能使用小於號(<)和大於號(>),這是因為瀏覽器會誤認為它們是標簽。如果希望正確地顯示預留字元,我們必須在 HTML 源代碼中使用字元實體(character entities)。 字元實體類似這樣: &entity_name; 或者 &#ent ...
  • 公司千萬級用戶應用繼續上新功能了,這次新功能主要迭代是小程式,讓小程式支持發佈商品功能,這是封裝weui上傳組件的原因,又是因為工作才去做的事情,我真是個不主動學習的人,先自責一下;這次記錄主要是考慮到其中的實現有很多小程式開發的細節,實現方案比較low,但是還是記一下這個上傳圖片+視頻的組件,其它 ...
  • 在網上看到一些朋友在查詢如何在電腦上下載tumblr(湯不熱)視頻,而本文將要介紹的「Tumblr.iiiLab.com」是一個免費的tumblr(湯不熱)線上視頻下載網站,下載方法很簡單,只需將視頻鏈接複製、粘貼到查詢框中,點擊查詢按鈕,然後就可快速保存mp4視頻到你PC或手機中。 網站訪問鏈接: ...
  • 記錄大話設計學習過程。 “工廠模式”和“簡單工廠模式”的區別就是把“到底實例哪一個對象的判斷邏輯”遷移出去。因為,如果是簡單工廠,哪天增加了新的運算,就必須修改簡單工廠類的判斷分支,這違反了“開放-封閉原則”。 現在判斷邏輯依然有,只是放在了客戶端,如果哪天增加新的運算,如果使用工廠模式,擴展就通過 ...
一周排行
    -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.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...