程式設計師如何畫好架構圖? - 最鐵資訊
文章推薦指數: 80 %
系統架構圖是為了抽象的表示軟體系統的整體輪廓和各個元件之間的相互關係和約束邊界,以及軟體系統的物理部署和軟體系統的演進方向的整體檢視。
3、架構圖 ...
首頁>科技>正文程式設計師如何畫好架構圖?2021-09-05由 俠夢的開發筆記 發表于 科技作者|三畫技術傳播的價值,不僅僅體現在透過商業化產品和開源專案來縮短我們構建應用的路徑,加速業務的上線速率,也體現在優秀工程師在工作效率提升、產品效能最佳化和使用者體驗改善等經驗方面的分享,以提高我們的專業能力。
本文作者阿里巴巴技術專家三畫,分享了自己和團隊在畫好架構圖方面的理念和經驗,首發於阿里內部技術分享平臺,阿里巴巴中介軟體授權轉載,梓敬、鵬升和餘樂對此文亦有貢獻。
當我們想用一張或幾張圖來描述我們的系統時,是不是經常遇到以下情況:對著畫布無從下手、刪了又來?用一張圖描述我的系統,並且讓產品、運營、開發都能看明白?畫了一半的圖還不清楚受眾是誰?畫出來的圖到底是產品圖功能圖還是技術圖又或是大雜燴?圖上的框框有點少是不是要找點兒框框加進來?佈局怎麼畫都不滿意……如果有同樣的困惑,本文將介紹一種畫圖的方法論,來讓架構圖更清晰。
先釐清一些基礎概念1、什麼是架構架構就是對系統中的實體以及實體之間的關係所進行的抽象描述,是一系列的決策。
架構是結構和願景。
系統架構是概念的體現,是對物/資訊的功能與形式元素之間的對應情況所做的分配,是對元素之間的關係以及元素同周邊環境之間的關係所做的定義。
做好架構是個複雜的任務,也是個很大的話題,本篇就不做深入了。
有了架構之後,就需要讓干係人理解、遵循相關決策。
2、什麼是架構圖系統架構圖是為了抽象的表示軟體系統的整體輪廓和各個元件之間的相互關係和約束邊界,以及軟體系統的物理部署和軟體系統的演進方向的整體檢視。
3、架構圖的作用一圖勝千言。
要讓干係人理解、遵循架構決策,就需要把架構資訊傳遞出去。
架構圖就是一個很好的載體。
那麼,畫架構圖是為了:解決溝通障礙達成共識減少歧義4、架構圖分類蒐集了很多資料,分類有很多,有一種比較流行的是4+1檢視,分別為場景檢視、邏輯檢視、物理檢視、處理流程檢視和開發檢視。
場景檢視場景檢視用於描述系統的參與者與功能用例間的關係,反映系統的最終需求和互動設計,通常由用例圖表示。
邏輯檢視邏輯檢視用於描述系統軟體功能拆解後的元件關係,元件約束和邊界,反映系統整體組成與系統如何構建的過程,通常由UML的元件圖和類圖來表示。
物理檢視物理檢視用於描述系統軟體到物理硬體的對映關係,反映出系統的元件是如何部署到一組可計算機器節點上,用於指導軟體系統的部署實施過程。
處理流程檢視處理流程檢視用於描述系統軟體元件之間的通訊時序,資料的輸入輸出,反映系統的功能流程與資料流程,通常由時序圖和流程圖表示。
開發檢視開發檢視用於描述系統的模組劃分和組成,以及細化到內部包的組成設計,服務於開發人員,反映系統開發實施過程。
以上5種架構檢視從不同角度表示一個軟體系統的不同特徵,組合到一起作為架構藍圖描述系統架構。
怎樣的架構圖是好的架構圖上面的分類是前人的經驗總結,圖也是從網上摘來的,那麼這些圖畫的好不好呢?是不是我們要依葫蘆畫瓢去畫這樣一些圖?先不去管這些圖好不好,我們透過對這些圖的分類以及作用,思考了一下,總結下來,我們認為,在畫出一個好的架構圖之前,首先應該要明確其受眾,再想清楚要給他們傳遞什麼資訊,所以,不要為了畫一個物理檢視去畫物理檢視,為了畫一個邏輯檢視去畫邏輯檢視,而應該根據受眾的不同,傳遞的資訊的不同,用圖準確地表達出來,最後的圖可能就是在這樣一些分類裡。
那麼,畫出的圖好不好的一個直接標準就是:受眾有沒有準確接收到想傳遞的資訊。
明確這兩點之後,從受眾角度來說,一個好的架構圖是不需要解釋的,它應該是自描述的,並且要具備一致性和足夠的準確性,能夠與程式碼相呼應。
畫架構圖遇到的常見問題1、方框代表什麼?為什麼適用方框而不是圓形,它有什麼特殊的含義嗎?隨意使用方框或者其它形狀可能會引起混淆。
2、虛線、實線什麼意思?箭頭什麼意思?顏色什麼意思?隨意使用線條或者箭頭可能會引起誤會。
3、執行時與編譯時衝突?層級衝突?架構是一項複雜的工作,只使用單個圖表來表示架構很容易造成莫名其妙的語義混亂。
本文推薦的畫圖方法C4模型使用容器(應用程式、資料儲存、微服務等)、元件和程式碼來描述一個軟體系統的靜態結構。
這幾種圖比較容易畫,也給出了畫圖要點,但最關鍵的是,我們認為,它明確指出了每種圖可能的受眾以及意義。
下面的案例來自C4官網,然後加上了一些我們的理解,來看看如何更好的表達軟體架構1、語境圖(SystemContextDiagram)這是一個想象的待建設的網際網路銀行系統,它使用外部的大型機銀行系統存取客戶賬戶、交易資訊,透過外部電郵系統給客戶發郵件。
可以看到,非常簡單、清晰,相信不需要解釋,都看的明白,裡面包含了需要建設的系統本身,系統的客戶,和這個系統有互動的周邊系統。
用途這樣一個簡單的圖,可以告訴我們,要構建的系統是什麼;它的使用者是誰,誰會用它,它要如何融入已有的IT環境。
這個圖的受眾可以是開發團隊的內部人員、外部的技術或非技術人員。
即:構建的系統是什麼誰會用它如何融入已有的IT環境怎麼畫中間是自己的系統,周圍是使用者和其它與之相互作用的系統。
這個圖的關鍵就是梳理清楚待建設系統的使用者和高層次的依賴,梳理清楚了畫下來只需要幾分鐘時間。
2、容器圖(ContainerDiagram)容器圖是把語境圖裡待建設的系統做了一個展開。
上圖中,除了使用者和外圍系統,要建設的系統包括一個基於java\springmvc的web應用提供系統的功能入口,基於xamarin架構的手機app提供手機端的功能入口,一個基於java的api應用提供服務,一個mysql資料庫用於儲存,各個應用之間的互動都在箭頭線上寫明瞭。
看這張圖的時候,不會去關注到圖中是直角方框還是圓角方框,不會關注是實線箭頭還是虛線箭頭,甚至箭頭的指向也沒有引起太多注意。
我們有許多的畫圖方式,都對框、線的含義做了定義,這就需要畫圖的人和看圖的人都清晰的理解這些定義,才能讀全圖裡的資訊,而現實是,這往往是非常高的一個要求,所以,很多圖只能看個大概的含義。
用途這個圖的受眾可以是團隊內部或外部的開發人員,也可以是運維人員。
用途可以羅列為:展現了軟體系統的整體形態體現了高層次的技術決策系統中的職責是如何分佈的,容器間的是如何互動的告訴開發者在哪裡寫程式碼怎麼畫用一個框圖來表示,內部可能包括名稱、技術選擇、職責,以及這些框圖之間的互動,如果涉及外部系統,最好明確邊界。
3、元件圖(ComponentDiagram)元件圖是把某個容器進行展開,描述其內部的模組。
用途這個圖主要是給內部開發人員看的,怎麼去做程式碼的組織和構建。
其用途有:描述了系統由哪些元件/服務組成釐清了元件之間的關係和依賴為軟體開發如何分解交付提供了框架4、類圖(Code/ClassDiagram)這個圖很顯然是給技術人員看的,比較常見,就不詳細介紹了。
案例分享下面是內部的一個實時資料工具的架構圖。
作為一個應該自描述的架構圖,這裡不多做解釋了。
如果有看不明白的,那肯定是還畫的不夠好。
畫好架構圖可能有許多方法論,本篇主要介紹了C4這種方法,C4的理論也是不斷進化的。
但不論是哪種畫圖方法論,我們回到畫圖初衷,更好的交流,我們在畫的過程中不必被條條框框所限制。
簡而言之,畫之前想好:畫圖給誰看,看什麼,怎麼樣不解釋就看懂。
往期推薦滴滴面試官:為什麼不建議把資料庫部署在Docker容器內?基於Redis點陣圖實現使用者簽到功能大資料架構PK:Hadoop與MPP的區別[專案原始碼]ERP進銷存系統純乾貨|從淘寶到雲端的高可用架構演進到底什麼是“超融合”呢?乾貨!Docker映象最佳化:從1。
16GB到20MB!上一篇:怎麼又是你?迴歸159天后,辛巴再遭封禁下一篇:iPhone13Pro疑似取消256GB?差價一下子貴了2000元TAG:
檢視架構圖系統架構元件相關推薦2022-01-31《不要在垃圾桶裡撿男朋友》:我來過,我棄權,超好的看快穿文2022-01-0311款素顏神器大測評!最後一款真的太心機了!2021-12-12華為出售X86伺服器業務新進展,知情人士:業務平穩過度中2021-11-18光伏龍頭企業合縱連橫或更進一步不約而同關注應用場景2021-10-09果斷收藏!醫患溝通的藝術,這篇文章總結的太全了!搜索推薦文章中國最詭異的三個村莊,一個村裡沒有人怪事頻發,白天都沒人敢進2022-03-28“夢幻風車,炫彩燈光”,為何小小的中華土司園,會有如此壯舉!2022-03-28古代戰爭中騎兵那麼厲害,古人用什麼“招數”剋制它2022-03-28嘴唇太厚,石原里美古裝造型天雷滾滾,難怪男生更愛新垣結衣!2022-03-28黑繃帶30%玻色因值得買嗎?貴婦效果難說,看你買虧了沒?2022-03-28頂部
延伸文章資訊
- 12022年最佳的8款流程圖軟體 - GitMind
- 2程式設計師你是怎麼繪製架構圖? - 人人焦點
- 3[工作筆記]關於UML的一點小分享. 前言 - Lily Ho
大學時期的程式課上學過如何畫程式的流程圖(點我看更多關於流程圖的介紹)來確認程式邏輯和架構、釐清思路,透過特定圖形取代固定文字來簡化說明,例如:橢圓形表示開始 ...
- 4工作兩三年了,整不明白架構圖都畫啥?
但是偏理科程式碼邏輯或架構設計,只能把抽象的內容用圖表的形式展現出來,讓大家在同一的共識下共同協同工作。 而我們畫的架構圖、流程圖、結構圖、功能 ...
- 5Draw.io 中文線上製作流程圖首選!專業水準完全免費 - 電 ...
最近在研究可以畫出流程圖、架構圖、線路圖、網站模板等圖表的製作工具,一開始先 ... 硬碟應用程式,這樣一來你可以從Google Drive 直接新增「 Draw.io 」的流程圖。