設計複雜的軟體系統不僅僅需要列出類別。您需要了解組件的內部結構。這正是「組合結構圖變得至關重要。它提供了分類器內部結構的詳細視圖，顯示各部分如何互動以實現功能。本指南將帶您一步步完成繪製這些圖表的過程，無需依賴特定工具。
理解組合結構圖 🧩
組合結構圖（CSD）代表分類器的內部結構。雖然標準的類圖顯示類別之間的關係，但CSD專注於單一類別或組件的內部。它回答的問題是：這個方框裡面是什麼？
- 分解： 它將一個複雜的元件分解為較小且可管理的部分。
- 協作： 它顯示這些部分如何協作以提供行為。
- 接口： 它定義內部元件如何與外部世界進行通訊。
當設計具有多層結構的系統時，例如微服務、圖形使用者介面或硬體與軟體整合，這種細節層級至關重要。它幫助架構師視覺化單一單元內的邊界與連接。
圖表的核心構建模塊 🧱
要有效繪製組合結構圖，您必須了解其基本元件。每個元件在定義內部架構時都具有特定用途。
1. 部分 🖥️
部分代表組合結構中分類器的實例。它是系統中的一個特定元件，對整體有所貢獻。在圖表中，部分通常以帶有範型「<<part>>」的矩形表示，其下方為實例名稱。
- 實例與類型：部分是實例，但由類別定義類型。您可能會有一個由「
databaseConnection」類別定義的「Connection」類別的「 - 多重性：部分可以具有多重性範圍，例如
1,0..1，或0..*，表示存在的實例數量。
2. 角色 🎭
角色定義了零件參與協作的狀態。零件可能在不同時間或不同情境下扮演不同的角色。
- 背景：角色明確了零件在結構中的責任。
- 標籤：角色通常放置在與零件相連的連接器末端附近。
3. 連接器 🔗
連接器代表零件之間的實體或邏輯連結。它們促進通訊與資料流動。
- 內部連結：連接器將同一個複合結構內的零件連結至其他零件。
- 綁定：連接器將角色綁定在一起，確保相容的介面能正確互動。
4. 埠 🌐
埠是組件與其環境之間的明確互動點。它可以是輸入、輸出，或兩者兼具。
- 封裝：埠隱藏組件的內部細節，使其對外部不可見。
- 介面：埠實現特定的介面，定義零件所提供的服務或所需的服務。
5. 介面 ⚙️
介面定義了互動的合約。在複合結構圖中，介面通常以棒棒糖符號（圓圈）或介面方框表示。
- 提供：組件提供此服務（棒棒糖）。
- 需要：組件需要此服務（插座）。
何時使用複合結構圖 📋
並非每個類別都需要複合結構圖。濫用會使文件混亂。當以下情況時使用此圖：
| 情境 | 原因 |
|---|---|
| 複雜組件 | 當一個類別具有許多內部依賴時。 |
| 硬體整合 | 當將軟體映射到實體裝置時。 |
| 通訊協定設計 | 當定義內部通訊流程時。 |
| GUI佈局 | 當顯示UI元素如何組成視窗時。 |
建立步驟 🛠️
建立複合結構圖需要有系統性的方法。遵循以下步驟以確保準確性與清晰度。
步驟 1：識別目標分類器 🎯
從您想要分析的類別或組件開始。這就是您的複合結構。確保您清楚了解其整體責任。
步驟 2：列出內部組件 🧱
將分類器拆解。哪些子組件使其運作？將它們列出來。以付款網關為例，組件可能包括驗證器, 加密器，以及記錄器.
- 為分類器繪製一個矩形。
- 在類別名稱下方添加一個區隔，用於結構。
- 在此區隔內為每個組件繪製矩形。
步驟 3：定義介面與埠 🌐
每個組件如何互動？識別每個組件所提供的或需要的介面。
- 在組件的邊界上繪製埠。
- 將介面符號連接到埠上。
- 清楚地標示埠（例如 “
輸入端口,輸出端口).
步驟 4：建立連接 🔗
在各部分之間繪製線條，以顯示它們如何進行通訊。這些線條即為連接器。
- 確保連接器連接的是相容的角色。
- 如有需要，使用箭頭表示方向。
- 以傳遞的資料或訊號類型標示連接器。
步驟 5：指定多重性與約束 📏
在連接器的末端加上數字，以表示有多少個實例被連接。
- 使用
1表示單一連接。 - 使用
0..*表示可選或多重連接。 - 若存在特定約束，請加上註解（例如，
threadSafe).
步驟 6：檢視與優化 🔍
檢查圖表的一致性。確保所有部分都已定義類型，所有端口都有介面，且流程邏輯通順。移除任何冗餘元素。
深入探討部分與角色 👥
理解「部分」與「角色」之間的細微差別，對於準確建模至關重要。
部分：實例
部分是位於結構內的實際物件。它是一個具體的實體。當您實例化一個組合時，會建立其部分的實例。
- 範例： 在一個
汽車結構中，一個引擎部件是特定的引擎實例。 - 標籤： 部件通常以斜體命名，以區分於類別名稱。
角色：容量
角色是零件在合作中被觀察的視角。單一零件在不同情境中可能扮演多個角色。
- 彈性： 角色允許同一個類別在不同的結構配置中重複使用。
- 溝通： 角色定義了連接的合約。
考慮一個 儲存裝置 類別。在一個圖表中，它可能扮演 備份目標 的角色。在另一個圖表中，它可能扮演 主要體積 的角色。零件保持不變，但角色會改變。
管理埠與連接器 🔌
埠與連接器是複合結構圖的生命線。它們定義了封裝的界限。
內部與外部互動
內部連接器將零件連結至其他零件。外部連接器則透過複合結構的埠，將零件連結至外部世界。
- 內部： 這些對複合結構的使用者是隱藏的。
- 外部： 這些透過複合結構自身的埠暴露出來。
介面實現
埠實現介面。這表示埠是抽象介面被實現的物理點。
- 提供的介面： 該組件透過此埠提供服務。
- 所需的介面： 該組件透過此埠消耗服務。
設計中的常見錯誤 ⚠️
避免這些陷阱，以維持您圖表的完整性。
- 過度設計： 不要為每個簡單類別都建立CSD。僅在內部複雜性值得時才使用。
- 遺漏的介面： 確保每個埠都有一個關聯的介面。未連接的埠會造成歧義。
- 忽略多重性： 未指定組件數量會導致實作時出現執行時間錯誤。
- 將組件與類別混淆： 請記住，組件是結構中的實例，而不僅僅是類別定義。
- 角色不清晰： 如果連接器未指定角色，則無法明確理解該連接的含義。
比較CSD與類別圖 📊
很容易將組合結構圖與類別圖混淆。以下是它們的差異。
| 特徵 | 類別圖 | 組合結構圖 |
|---|---|---|
| 重點 | 類別之間的關係。 | 單一類別的內部組成。 |
| 細節層級 | 高階系統視圖。 | 低階組件視圖。 |
| 元素 | 屬性、操作、關聯。 | 零件、埠、連接器、角色。 |
| 使用方式 | 資料庫結構、API設計。 | 系統架構、UI佈局。 |
清晰度的最佳實務 ✨
遵循這些指南，以確保您的圖表清晰易讀且可維護。
- 保持焦點：一個圖表應僅代表一個特定的分類器。
- 使用一致的命名：確保零件名稱與類別名稱遵循相同的命名規範。
- 減少線條：安排零件以減少交叉線條的數量。
- 將相關零件分組：若圖表過於龐大，可使用次結構或巢狀區隔。
- 記錄約束條件：為無法以視覺方式呈現的複雜邏輯添加註解。
維護與演進 🔄
軟體會隨時間變更。組合結構圖必須隨著程式碼一同演進。
- 版本控制：將圖表視為程式碼。儲存在您的程式碼庫中。
- 重構：若重構內部結構，應立即更新圖表。
- 審查：在架構審查中包含CSD（組合結構圖），以早期發現結構上的不一致。
- 自動化：在可能的情況下，從程式碼產生圖表，以保持同步。
最終考量 🔍
建立組合結構圖是一種嚴謹的分解練習。它迫使你思考系統的內部機制，而不僅僅是外部行為。透過理解零件、角色、埠與連接器，你將具備設計模組化、可維護且可擴展系統的能力。
請記住，圖表是溝通工具。其主要目標是清楚地向利害關係人、開發人員與架構師傳達資訊。不要迷失在細節中；專注於重要的結構。經過練習，繪製這些圖表將自然地成為你設計流程的一部分。
從最簡單的結構開始，逐步增加複雜度。隨著技能的精進，你會發現這些圖表提供了實作的路徑，其價值往往超過程式碼本身。它們是驅動你軟體內部邏輯的藍圖。