阿里:如何畫好架構圖

作者 | 三畫

來源 | 阿里巴巴中間件

技術傳播的價值,不僅僅體現在通過商業化產品和開源項目來縮短我們構建應用的路徑,加速業務的上線速率,也體現在優秀工程師在工作效率提升、產品性能優化和用戶體驗改善等經驗方面的分享,以提高我們的專業能力。

本文作者阿里巴巴技術專家三畫,分享了自己和團隊在畫好架構圖方面的理念和經驗,首發於阿里內部技術分享平臺,阿里巴巴中間件授權轉載,梓敬、鵬升和餘樂對此文亦有貢獻。

當我們想用一張或幾張圖來描述我們的系統時,是不是經常遇到以下情況:

如果有同樣的困惑,本文將介紹一種畫圖的方法論,來讓架構圖更清晰。

先釐清一些基礎概念

1、什麼是架構

架構就是對系統中的實體以及實體之間的關係所進行的抽象描述,是一系列的決策。

架構是結構和願景。

系統架構是概念的體現,是對物 / 信息的功能與形式元素之間的對應情況所做的分配,是對元素之間的關係以及元素同周邊環境之間的關係所做的定義。

做好架構是個複雜的任務,也是個很大的話題,本篇就不做深入了。有了架構之後,就需要讓干係人理解、遵循相關決策。

2、什麼是架構圖

系統架構圖是爲了抽象的表示軟件系統的整體輪廓和各個組件之間的相互關係和約束邊界,以及軟件系統的物理部署和軟件系統的演進方向的整體視圖。

3、架構圖的作用

一圖勝千言。要讓干係人理解、遵循架構決策,就需要把架構信息傳遞出去。架構圖就是一個很好的載體。那麼,畫架構圖是爲了:

這代碼有毒...

4、架構圖分類

蒐集了很多資料,分類有很多,有一種比較流行的是 4+1 視圖,分別爲場景視圖、邏輯視圖、物理視圖、處理流程視圖和開發視圖。

場景視圖用於描述系統的參與者與功能用例間的關係,反映系統的最終需求和交互設計,通常由用例圖表示。

Netflix 開源用於 Spring Boot 的 GraphQL 服務框架 DGS

邏輯視圖用於描述系統軟件功能拆解後的組件關係,組件約束和邊界,反映系統整體組成與系 統如何構建的過程, 通常由 UML 的組件圖和類圖來表示。

再見,xShell,自己用 Java 擼一個 Web 版的,網友直呼:666

物理視圖用於描述系統軟件到物理硬件的映射關係,反映出系統的組件是如何部署到一組可 計算機器節點上,用於指導軟件系統的部署實施過程。

Java 中 sin、log、tan 等複雜數學運算怎麼搞?

處理流程視圖用於描述系統軟件組件之間的通信時序,數據的輸入輸出,反映系統的功能流程 與數據流程, 通常由時序圖和流程圖表示。

聽說我們的元宵節,跟別人的不一樣...

開發視圖用於描述系統的模塊劃分和組成,以及細化到內部包的組成設計,服務於開發人員,反映系統開發實施過程。

不講武德,拿到戶口後立馬辭職...

以上 5 種架構視圖從不同角度表示一個軟件系統的不同特徵,組合到一起作爲架構藍圖描述系統架構。

怎樣的架構圖是好的架構圖

上面的分類是前人的經驗總結,圖也是從網上摘來的,那麼這些圖畫的好不好呢?是不是我們要依葫蘆畫瓢去畫這樣一些圖?

先不去管這些圖好不好,我們通過對這些圖的分類以及作用,思考了一下,總結下來,我們認爲,在畫出一個好的架構圖之前, 首先應該要明確其受衆,再想清楚要給他們傳遞什麼信息 ,所以,不要爲了畫一個物理視圖去畫物理視圖,爲了畫一個邏輯視圖去畫邏輯視圖,而應該根據受衆的不同,傳遞的信息的不同,用圖準確地表達出來,最後的圖可能就是在這樣一些分類裏。那麼,畫出的圖好不好的一個直接標準就是:受衆有沒有準確接收到想傳遞的信息。

明確這兩點之後,從受衆角度來說,一個好的架構圖是不需要解釋的,它應該是自描述的,並且要具備一致性和足夠的準確性,能夠與代碼相呼應。

畫架構圖遇到的常見問題

1、方框代表什麼?

謹記!怎麼樣的編程會讓你進監獄?

爲什麼適用方框而不是圓形,它有什麼特殊的含義嗎?隨意使用方框或者其它形狀可能會引起混淆。

2、虛線、實線什麼意思?箭頭什麼意思?顏色什麼意思?

隨意使用線條或者箭頭可能會引起誤會。

3、運行時與編譯時衝突?層級衝突?

架構是一項複雜的工作,只使用單個圖表來表示架構很容易造成莫名其妙的語義混亂。

本文推薦的畫圖方法

505 天,240,000 字,我總結了 Spring Security 的學習曲線,免費送給大家 C4 模型使用容器(應用程序、數據存儲、微服務等)、組件和代碼來描述一個軟件系統的靜態結構。這幾種圖比較容易畫,也給出了畫圖要點,但最關鍵的是,我們認爲,它明確指出了每種圖可能的受衆以及意義。

下面的案例來自 C4 官網,然後加上了一些我們的理解,來看看如何更好的表達軟件架構

1、語境圖 (System Context Diagram)

搞開源也會被死亡恐嚇!

這是一個想象的待建設的互聯網銀行系統,它使用外部的大型機銀行系統存取客戶賬戶、交易信息,通過外部電郵系統給客戶發郵件。可以看到,非常簡單、清晰,相信不需要解釋,都看的明白,裏面包含了需要建設的系統本身,系統的客戶,和這個系統有交互的周邊系統。

用途

這樣一個簡單的圖,可以告訴我們,要構建的系統是什麼;它的用戶是誰,誰會用它,它要如何融入已有的 IT 環境。這個圖的受衆可以是開發團隊的內部人員、外部的技術或非技術人員。即:

怎麼畫

中間是自己的系統,周圍是用戶和其它與之相互作用的系統。這個圖的關鍵就是梳理清楚待建設系統的用戶和高層次的依賴,梳理清楚了畫下來只需要幾分鐘時間。

2、容器圖 (Container Diagram)

容器圖是把語境圖裏待建設的系統做了一個展開。

@Autowire 和 @Resource 註解使用的正確姿勢,別再用錯的了!!

上圖中,除了用戶和外圍系統,要建設的系統包括一個基於 java\spring mvc 的 web 應用提供系統的功能入口,基於 xamarin 架構的手機 app 提供手機端的功能入口,一個基於 java 的 api 應用提供服務,一個 mysql 數據庫用於存儲,

各個應用之間的交互都在箭頭線上寫明瞭。

看這張圖的時候,不會去關注到圖中是直角方框還是圓角方框,不會關注是實線箭頭還是虛線箭頭,甚至箭頭的指向也沒有引起太多注意。

我們有許多的畫圖方式,都對框、線的含義做了定義,這就需要畫圖的人和看圖的人都清晰的理解這些定義,才能讀全圖裏的信息,而現實是,這往往是非常高的一個要求,所以,很多圖只能看個大概的含義。

用途

這個圖的受衆可以是團隊內部或外部的開發人員,也可以是運維人員。用途可以羅列爲:

怎麼畫

用一個框圖來表示,內部可能包括名稱、技術選擇、職責,以及這些框圖之間的交互,如果涉及外部系統,最好明確邊界。

3、組件圖 (Component Diagram)

Java 實現 pdf 和 Excel 的生成及數據動態插入、導出

組件圖是把某個容器進行展開,描述其內部的模塊。

用途

這個圖主要是給內部開發人員看的,怎麼去做代碼的組織和構建。其用途有:

4、類圖 (Code/Class Diagram)

好用到爆!多種數據庫只需一個工具就能搞定!

這個圖很顯然是給技術人員看的,比較常見,就不詳細介紹了。

案例分享

下面是內部的一個實時數據工具的架構圖。作爲一個應該自描述的架構圖,這裏不多做解釋了。如果有看不明白的,那肯定是還畫的不夠好。

超詳細解讀 Java 接口:模塊通信協議以及默認方法和靜態方法

畫好架構圖可能有許多方法論,本篇主要介紹了 C4 這種方法,C4 的理論也是不斷進化的。但不論是哪種畫圖方法論,我們回到畫圖初衷,更好的交流,我們在畫的過程中不必被條條框框所限制。簡而言之,畫之前想好:畫圖給誰看,看什麼,怎麼樣不解釋就看懂。

參考資料:

C4 官網:

https://c4model.com/

爲什麼需要軟件架構圖:

https://www.infoq.cn/article/GhprrUlOYyOqS8*FR1pH

書籍:《程序員必讀之軟件架構》

本文由 Readfog 進行 AMP 轉碼,版權歸原作者所有。
來源https://mp.weixin.qq.com/s/m5Fh_ZAdqf_chqudaRJECw