设计复杂的软件系统不仅仅需要列出类。你还需要理解组件的内部结构。这就是“组合结构图变得至关重要。它提供了分类器内部结构的详细视图，展示了各个部分如何相互作用以实现功能。本指南将带你一步步创建这些图表，而无需依赖特定工具。
理解组合结构图 🧩
组合结构图（CSD）表示分类器的内部结构。虽然标准类图展示类之间的关系，但CSD则专注于单个类或组件的内部。它回答的问题是：这个框里有什么？
- 分解： 它将一个复杂元素分解为更小、更易管理的部分。
- 协作： 它展示了这些部分如何协同工作以提供行为。
- 接口： 它定义了内部部分如何与外部世界通信。
在设计具有多层结构的系统（如微服务、GUI或软硬件集成）时，这种细节程度至关重要。它帮助架构师可视化单个单元内的边界和连接。
图表的核心构建模块 🧱
要有效地绘制组合结构图，你必须理解其基本元素。每个元素在定义内部架构方面都具有特定作用。
1. 部分 🖥️
部分表示复合结构中分类器的一个实例。它是系统中一个具体的组成部分，对整体有贡献。在图表中，部分通常以一个矩形表示，带有构造型<<part>>，并在其下方标注实例名称。
- 实例与类型： 部分是一个实例，但它由一个类来定义类型。你可能会有一个由
databaseConnection类型定义的Connection类的部分。 - 多重性： 一个部分可以具有一个多重性范围，例如
1,0..1，或0..*，表示存在的实例数量。
2. 角色 🎭
角色定义了部件在协作中所扮演的职能。一个部件可能在不同时间或不同情境下扮演不同的角色。
- 上下文：角色明确了部件在结构中的职责。
- 标记：角色通常放置在与部件相连的连接器末端附近。
3. 连接器 🔗
连接器表示部件之间的物理或逻辑连接。它们促进了通信和数据流动。
- 内部连接：连接器将同一复合结构内的部件与其他部件连接起来。
- 绑定：连接器将角色绑定在一起，确保兼容的接口能够正确交互。
4. 端口 🌐
端口是组件与其环境之间的特定交互点。它可以是输入、输出，或两者兼具。
- 封装：端口隐藏了组件的内部细节，使其对外不可见。
- 接口：端口实现特定接口，定义了部件所提供的服务或所需的服务。
5. 接口 ⚙️
接口定义了交互的契约。在复合结构图中，接口通常使用棒棒糖符号（圆圈）或接口框来表示。
- 提供：组件提供此服务（棒棒糖）。
- 需要：组件需要此服务（插座）。
何时使用复合结构图 📋
并非每个类都需要复合结构图。随意使用会使得文档杂乱。在以下情况使用此图：
| 场景 | 原因 |
|---|---|
| 复杂组件 | 当一个类具有许多内部依赖时。 |
| 硬件集成 | 当将软件映射到物理设备时。 |
| 协议设计 | 当定义内部通信流程时。 |
| GUI布局 | 当展示UI元素如何组成一个窗口时。 |
创建步骤 🛠️
创建复合结构图需要有条不紊的方法。遵循以下步骤以确保准确性和清晰性。
步骤1：识别目标分类器 🎯
从您想要分析的类或组件开始。这就是您的复合结构。确保您对其整体职责有清晰的理解。
步骤2：列出内部部件 🧱
将分类器分解。哪些子组件使其运行？将它们列出来。对于支付网关，部件可能包括验证器, 加密器，以及日志记录器.
- 为分类器绘制一个矩形。
- 在类名下方添加一个用于结构的分隔区。
- 在此分隔区内为每个部件绘制矩形。
步骤3：定义接口和端口 🌐
每个部件如何交互？识别每个部件提供的或需要的接口。
- 在部件的边界上绘制端口。
- 将接口符号连接到端口上。
- 清晰地标记端口（例如，”
输入端口,输出端口).
步骤 4：建立连接 🔗
在各个部件之间绘制线条，以显示它们如何通信。这些线条即为连接器。
- 确保连接器连接的是兼容的角色。
- 如有必要，请使用箭头表示方向。
- 用正在传递的数据或信号类型来标注连接器。
步骤 5：指定多重性与约束 📏
在连接器的末端添加数字，以表示连接了多少个实例。
- 使用
1表示单一连接。 - 使用
0..*表示可选或多个连接。 - 如果存在特定约束，请添加注释（例如，
线程安全).
步骤 6：审查与优化 🔍
检查图表的一致性。确保所有部件都已定义类型，所有端口都有接口，并且流程在逻辑上合理。删除任何冗余元素。
深入探究部件与角色 👥
理解 部件 与 角色之间的细微差别对于准确建模至关重要。
部件：实例
部件是结构内部实际存在的对象。它是一个具体的实体。当你实例化一个复合体时，你就会创建其部件的实例。
- 示例： 在一个
汽车结构中，一个发动机部分是一个特定的发动机实例。 - 标注： 部分通常以斜体命名，以区别于类名。
角色：能力
角色是从协作中观察部分的视角。一个部分在不同上下文中可能扮演多个角色。
- 灵活性： 角色允许同一类在不同的结构配置中被重用。
- 通信： 角色定义了连接的契约。
考虑一个 存储设备 类。在一个图中，它可能扮演 备份目标 的角色。在另一个图中，它可能扮演 主卷 的角色。部分保持不变，但角色发生了变化。
管理端口和连接器 🔌
端口和连接器是复合结构图的生命线。它们定义了封装的边界。
内部与外部交互
内部连接器将部分连接到其他部分。外部连接器通过复合体的端口将部分连接到外部世界。
- 内部： 这些对复合体的用户是隐藏的。
- 外部： 这些通过复合体自身的端口暴露出来。
接口实现
端口实现接口。这意味着端口是抽象接口被实现的物理点。
- 提供的接口： 该部分通过此端口提供服务。
- 所需的接口： 该部分通过此端口使用服务。
设计中的常见错误 ⚠️
避免这些陷阱，以保持图表的完整性。
- 过度设计： 不要为每个简单类都创建一个CSD。只有在内部复杂性值得时才使用。
- 缺失的接口： 确保每个端口都有相关联的接口。未连接的端口是模糊的。
- 忽略多重性： 未能指定存在的部件数量，可能导致实现时出现运行时错误。
- 将部件与类混淆： 记住，部件是结构内的实例，而不仅仅是类定义。
- 角色不明确： 如果连接器未指定角色，则连接的解释方式不明确。
比较CSD与类图 📊
很容易将复合结构图与类图混淆。以下是它们的区别。
| 特性 | 类图 | 复合结构图 |
|---|---|---|
| 关注点 | 类之间的关系。 | 单个类的内部组成。 |
| 粒度 | 高层次的系统视图。 | 低层次的组件视图。 |
| 元素 | 属性、操作、关联。 | 部件、端口、连接器、角色。 |
| 用途 | 数据库模式，API设计。 | 系统架构，UI布局。 |
清晰度的最佳实践 ✨
遵循这些指南，以确保您的图表清晰且易于维护。
- 保持聚焦：一个图表应仅表示一个特定的分类器。
- 使用一致的命名：确保部件名称和类名称遵循相同的命名规范。
- 减少连线：合理安排部件，以减少交叉连线的数量。
- 分组相关部件：如果图表过于庞大，可使用子结构或嵌套容器。
- 记录约束条件：为无法通过视觉展示的复杂逻辑添加注释。
维护与演进 🔄
软件会随时间变化。复合结构图必须随着代码一同演进。
- 版本控制：将图表视为代码。将其存储在您的代码仓库中。
- 重构：如果重构内部结构，请立即更新图表。
- 评审：在架构评审中包含CSD（复合结构图），以尽早发现结构上的不一致。
- 自动化：在可能的情况下，从代码生成图表，以保持其同步。
最终考量 🔍
创建复合结构图是一项严谨的分解练习。它迫使你思考系统的内部机制，而不仅仅是外部行为。通过理解部件、角色、端口和连接器，你将具备设计模块化、可维护且可扩展系统的能力。
请记住，图表是沟通工具。它们的主要目标是向利益相关者、开发人员和架构师清晰地传达信息。不要陷入细节之中；专注于重要的结构。通过练习，绘制这些图表将成为你设计过程中的自然组成部分。
从最简单的结构开始，逐步增加复杂性。随着技能的提升，你会发现这些图表为实现提供了路线图，其价值往往超过代码本身。它们是驱动你软件内部逻辑的蓝图。