軟體架構通常以元件及其互動來描述。雖然標準的類圖顯示靜態關係，但往往無法揭示複雜分類器的內部組成。這正是「UML組合結構圖變得至關重要。它提供了分類器內部結構的詳細視圖，顯示其各部分如何互動以滿足系統的需求。
本指南探討了創建這些圖表的機制。我們將檢視核心元素、符號表示法以及實際應用。結束時，您將了解如何明確地建模複雜的嵌套結構。
🧩 什麼是組合結構圖？
組合結構圖（CSD）是一種UML圖表，用於描述分類器的內部結構。它專注於構成整體的各個部分，以及這些部分用來通訊的介面。與專注於屬性和操作的類圖不同，CSD專注於組成與互動。
將組合結構圖視為軟體元件的X光片。它揭示了引擎蓋下的機械結構。這在處理以下情況時尤為有用：
- 複雜的嵌套結構
- 具有多個介面的元件
- 需要嚴格邊界定義的系統
- 高度依賴委派與埠的架構
此圖表讓架構師能夠直觀地了解系統是如何由較小且可重用的元件組成的。它明確了內部元件與外部環境之間的合約。
🛠 核心元素與符號表示法
要繪製有效的UML組合結構圖，您必須了解其構成模組。每個元素都有特定用途與視覺表現方式。
1. 部分
部分代表分類器內部結構的一個組成部分。它是存在於組合體內的分類器實例。部分具有名稱與類型。
- 視覺表現： 帶有符號 <<part>> 的矩形，或僅僅是部分名稱與類型。
- 角色： 部分可能在互動中扮演特定角色。
- 可見性： 部分可以是公開、私有或受保護的。
2. 埠
埠是部分或分類器的互動點。它定義了部分如何與外部世界或其他部分連接。埠封裝了部分所提供的或需要的介面。
- 提供的介面： 以棒棒糖符號表示，代表提供給外部的功能。
- 所需的介面： 以插座符號表示，代表需要來自外部的功能。
- 方向性： 端口可以是输入、输出，或两者兼具。
3. 角色
當一個零件連接到連接器時，會根據特定的角色進行連接。角色定義了該零件在協作中的參與方式。例如，資料庫零件可能扮演「儲存」的角色，而控制器零件則扮演「管理員」的角色。
4. 連接器
連接器代表零件之間或零件與端口之間的連結。它們定義了資料或控制流的路徑。
- 綁定連接器： 將提供的介面連接到所需的介面。
- 委派連接器： 將複合元件的端口連接到內部零件的端口。
📊 比較：類圖與組合結構圖
了解何時應使用組合結構圖而非類圖，對於有效建模至關重要。以下是兩者的差異詳述。
| 特徵 | 類圖 | 組合結構圖 |
|---|---|---|
| 重點 | 屬性和操作 | 內部組成與互動 |
| 細節層級 | 邏輯結構 | 物理或邏輯組成 |
| 關係 | 關聯、聚合、繼承 | 零件、端口、連接器、角色 |
| 複雜度 | 平面結構 | 支援巢狀結構 |
| 用途 | 一般資料建模 | 組件架構設計 |
用類圖來表示一般性的資料關係。當組件的內部連接對系統行為有顯著影響時，應使用組合結構圖。
🛤 分步指南：建立組合結構圖
遵循此邏輯流程，從零開始建立圖表。此工作流程可確保一致性和清晰度。
步驟 1：定義分類器
首先識別您想要分析的分類器。這通常是一個需要內部分解的複雜類別或組件。繪製代表此分類器的主要矩形。
步驟 2：識別內部組件
將分類器分解為其組成組件。問自己：哪些較小的組件構成了這個系統？將它們列為主要矩形內的組件，並為每個組件分配類型。
步驟 3：定義介面
確定每個組件所公開的功能以及它所需的內容。在相關組件上繪製棒棒糖符號表示提供的介面，以及插座符號表示所需的介面。
步驟 4：連接組件
在組件之間繪製連接器。確保每個所需的介面都連接到對應的提供的介面。如果需要透過主要分類器的埠公開內部功能，請使用委派連接器。
步驟 5：新增角色與多重性
以角色標示連接器的兩端。如果組件可以有多個實例或關係，請指定多重性。這能提升模型的精確度。
💡 實際範例：汽車控制系統
讓我們將這些概念應用於現實世界的情境中。想像一下，為一輛自駕車的控制系統建立模型。
- 分類器：VehicleControlSystem
- 組件：
- SensorModule（類型：SensorArray）
- ProcessingUnit（類型：CPU）
- ActuatorModule（類型：MotorController）
- 埠：
- SensorPort（所需：RawData）
- CommandPort（提供：ControlSignal）
在此模型中：
- 而SensorModule提供原始資料。它透過連結器與ProcessingUnit相連。
- 而處理單元 分析資料並需要控制訊號介面。
- 該致動器模組 提供控制訊號。它連接到處理單元。
- 該車輛控制系統 暴露一個命令埠 會委派給致動器模組。
此結構顯示外部命令如何透過內部處理傳送到實際致動器。它清楚地呈現資料路徑，而不會使高階設計變得混亂。
🎯 模型設計的最佳實務
為保持清晰與實用性，繪製圖表時請遵循以下指南。
- 限制巢狀深度： 深層嵌套的結構會變得難以閱讀。如果某個組件需要自己的內部圖表，請考慮為其建立獨立的圖表。
- 使用明確的命名： 避免使用如「Part1」等通用名稱。應使用如「資料庫連接器」或「使用者介面」等描述性名稱。
- 最小化跨連接： 儘量讓連接器保持在分類器內部。如果某組件連接到外部系統，請使用委派連接器指向主要分類器的埠。
- 一致的符號使用： 使用標準的 UML 符號。不要自行創造自訂圖示。
- 專注於互動： 不需建模每個屬性。專注於定義行為的介面與連接。
🔍 應避免的常見錯誤
即使經驗豐富的建模者也會犯錯。以下是一些應注意的常見問題。
- 混淆埠與介面： 埠是互動的點；介面是一份合約。埠會實作介面。
- 圖表過於複雜： 如果圖表跨及多頁，表示組件可能過多。應將分類器進行分解。
- 遺漏委派 如果內部組件提供外部所需的服務，則必須使用委派連接器連接到主端口。
- 忽略多重性： 未指定組件實例數量可能會導致實現錯誤。
📈 何時使用此圖表
並非每個組件都需要複合結構圖。當以下情況時使用：
- 內部接線複雜且影響外部行為。
- 您需要指定內部組件的重用。
- 您正在為組件部署定義嚴格的邊界。
- 您需要記錄介面的委派。
對於具有簡單屬性的簡單類別，類圖已足夠。將複合結構圖保留給高價值的架構決策使用。
🧠 進階概念
隨著您變得更加熟練，可以探索符號的進階功能。
代理端口
代理端口作為尚未實現組件的佔位符。它允許您在組件建成前設計系統流程。
值規範
您可以在組件定義中指定某些屬性的固定值。這對於配置參數非常有用。
行為協議
端口可以與狀態機關聯。這定義了該端口允許的互動順序。
📝 重點摘要
總結設計工作的關鍵要點：
- 複合結構圖揭示內部組成。
- 組件、端口、角色和連接器是核心元素。
- 明確區分提供的介面與所需的介面。
- 使用委派連接器來公開內部功能。
- 透過避免過度嵌套來保持圖表的可讀性。
- 根據系統的執行時行為來驗證您的模型。
掌握此圖表類型可為您的架構文檔增添深度。它彌補了高階設計與低階實現細節之間的差距。遵循這些指南，您可以創建清晰且易於維護的模型，有效支援您的團隊。
❓ 常見問題
我能否結合類圖與複合結構圖？
可以。使用類圖來表示整體資料模型，使用複合結構圖來描述特定的複雜組件。它們相互補充。
我需要在組合結構圖中顯示每一個方法嗎？
不需要。專注於互動。方法屬於零件的操作，而非結構本身。
如果我有零件的多個實例該怎麼辦？
在連接器的一端指定多重性。這表示所需的或允許的實例數量。
這個圖表是否被所有建模工具支援？
大多數現代建模工具支援標準的UML符號，但有些工具在進階功能（例如巢狀組合結構）上可能有特定限制。
🏁 最後的想法
建模軟體架構是一種追求清晰的練習。這個UML組合結構圖提供了一個強大的視角，用來檢視系統是如何組裝的。透過理解零件、埠和連接，你就能掌控設計的複雜性。運用這個工具來記錄、溝通並驗證你的架構決策。經過練習，這些圖表將成為你設計流程中不可或缺的一部分。
