软件系统和复杂的硬件架构很少是简单的。随着需求的增长，组件的内部连接变得错综复杂。标准图表通常展示什么存在，但它们难以展示如何部件如何在特定分类器内部组合在一起。这就是UML复合结构图变得至关重要的地方。它提供了对分类器内部结构的细致视图，揭示了部件、角色和连接器之间的关系。
如果没有这种详细程度，架构师可能会构建出难以维护或扩展的系统。理解类或组件的内部组成对于高保真建模至关重要。本指南探讨了此类图表的必要性，并提供了一套清晰的创建方法。
什么是复合结构图？🧩
复合结构图（CSD）是统一建模语言中的一种结构图。它用于建模分类器的内部结构及其内部部件之间的交互。虽然类图展示属性和方法，组件图展示可部署单元，但CSD聚焦于内部机制.
可以将其想象为房屋中某个特定房间的蓝图，而不是整栋建筑的平面图。它详细说明：
- 部件： 分类器内部的各个组件。
- 角色： 部件所扮演的接口或职责。
- 端口： 与外部世界交互的点。
- 连接器： 部件之间的连接。
当处理需要严格内部边界或内部布线决定系统行为的系统时，该图表尤其有价值。
复合结构图的构成 🔍
要绘制出有效的图表，你必须理解基本构件。这些元素定义了系统内部的关系和边界。
1. 部件 🧱
部件是被复合分类器所拥有的分类器的实例。它代表了较大结构内部的一个组件。在软件上下文中，部件可能是一个子程序、数据库连接池或特定模块。
- 可见性： 部件可以是公共的、私有的或受保护的。
- 多重性： 你可以指定部件实例的数量（例如，1，0..*，1..1）。
2. 角色 🎭
当一个部件与另一个部件或外部世界交互时，它会以特定的方式进行。这种特定方式就是角色。一个部件在不同时刻或针对不同交互时，可能扮演多个角色。
- 角色通常由接口表示。
- 它们定义了该部件所提供的服务或所需的服务。
3. 端口 📡
端口是分类器上的一个命名交互点。它作为内部结构与外部环境之间的边界。可以将端口想象成主板上的插槽；它允许外部电缆连接到内部电路。
- 提供的接口： 端口向其他部件提供的功能。
- 所需的接口： 端口为了正常运行所需从其他部件获取的功能。
4. 连接器 🔗
连接器连接交互点。它们定义了数据或控制在部件之间，或在部件与外部环境之间流动的方式。
- 内部连接器： 连接同一复合分类器内的部件。
- 外部连接器： 将复合分类器的端口连接到其他分类器。
为什么你的架构需要这种视图 📈
许多架构师仅依赖类图或顺序图。虽然这些图很有用，但它们常常忽略了复杂系统所需的结构细节。以下是为何你应该投入时间学习复合结构图（CSD）的原因。
1. 明确内部复杂性 🧠
当一个类变得过于复杂时，它就会变成一个“上帝对象”。复合结构图迫使你将其拆分。它能可视化责任的委派。如果一个类包含太多部件，你就知道它需要重构了。
2. 管理边界 🚧
端口和接口定义了严格的边界。它们防止内部实现细节泄露到公共API中。这支持封装原则，使系统对变更更具鲁棒性。
3. 硬件-软件协同设计 🖥️
嵌入式系统通常混合了软件和硬件。复合结构图可以建模一个包含特定软件驱动程序（部件）的微控制器（硬件）。这种混合建模在标准UML图中难以实现，但却是复合结构图的原生能力。
4. 重用与组合 ♻️
设计模式通常依赖于组合。通过显式地建模部件，你可以在不同的分类器之间重用内部结构。如果你一次定义了一个“日志系统”部件，就可以将其插入到多个分类器中。
复合结构图（CSD）与其他UML图的对比 🔄
理解何时使用复合结构图，需要了解它与其他UML图的区别。下表概述了这些差异。
| 图类型 | 关注点 | 最适合用于 |
|---|---|---|
| 类图 | 静态结构、属性、方法 | 数据库模式，一般对象关系 |
| 组件图 | 高层部署，物理文件 | 系统部署，模块边界 |
| 组合结构图 | 内部结构、部件、角色、端口 | 复杂的内部布线、嵌入式系统、详细设计 |
| 对象图 | 特定时刻的运行时实例 | 状态快照，测试场景 |
请注意，CSD位于抽象的类图和物理的组件图之间。它弥合了逻辑设计与物理实现之间的差距。
绘制一个的逐步指南 📝
创建一个图表需要有条不紊的方法。不要一上来就画方框。应从分析需求开始。
步骤1：识别分类器 🏷️
决定你要建模的是哪个类或组件。它是一个特定的服务吗？一个硬件控制器吗？确保这个分类器足够复杂，值得进行内部分解。如果它只有两个属性，那么使用CSD就过于复杂了。
步骤2：定义部件 🛠️
列出构成分类器的内部组件。这些应该是逻辑上的工作单元。
- 分解职责。一个部件负责数据处理吗？另一个负责逻辑处理吗？
- 分配多重性。可以没有部件，还是必须恰好有一个？
- 为部件使用标准分类器（例如，数据库连接、日志记录器）。
步骤3：指定端口和接口 🔌
针对每个部件，确定它如何通信。
- 这个部件运行需要什么？（所需接口）
- 这个部件向其他部分提供什么？（提供接口）
- 在主分类器上定义端口。这些是外部世界的入口点。
步骤4：绘制连接器 ⛓️
将各个部件连接起来。这就是逻辑流动的地方。
- 将一个部件的输出连接到另一个部件的输入。
- 确保连接点处的数据类型匹配。
- 如果连接器是单向的，请标明其方向。
步骤 5：审查与验证 ✅
浏览一下这个图。如果某个特定部分失效，系统还能运行吗？是否存在循环依赖？外部接口是否与内部实际情况一致？
现实世界的应用 💻
为了使这一点更具体，让我们看看它如何应用于实际的工程场景。
场景 1：微服务架构 🔗
在微服务环境中，“支付服务”可能包含内部组件：事务日志记录器、欺诈检测器和网关适配器。CSD 展示了网关适配器在事务日志记录器记录数据之前，将数据传递给欺诈检测器的过程。这在无需完整序列图的情况下，明确了执行顺序。
场景 2：嵌入式控制系统 🚗
汽车制动系统包括传感器、控制器和执行器。CSD 用于建模控制器的内部逻辑。它展示了传感器部分需要数据流，计算部分使用该数据流，执行器部分接收指令。这直观地体现了软件与硬件驱动之间的紧密耦合。
场景 3：GUI 框架 🖱️
一个窗口控件通常包含更小的组成部分：标题栏、内容区域和关闭按钮。每个部分都有其独立的行为。CSD 定义了这些部分的排列方式，以及当用户点击关闭按钮时它们之间的通信方式。
应避免的常见错误 ⚠️
即使是经验丰富的架构师在建模时也会犯错。请注意这些陷阱。
- 过度建模： 不要为每个类都创建 CSD。仅对复杂结构进行建模。当内部连接关系重要时才使用。
- 忽略多重性： 未明确说明组件的数量会导致歧义。一个系统可能需要三个缓冲区实例，而不仅仅是其中一个。
- 混用层级： 不要在同一张图中混用高层组件和低层变量。保持粒度一致。
- 遗漏端口： 确保所有外部交互都通过端口进行。内部组件直接连接到外部世界会破坏封装性。
维护的最佳实践 🛠️
图表是动态文档，必须随着代码的演进而更新。
- 保持更新： 如果代码发生变化，图表也必须随之更新。一份过时的图表比没有图表更令人困惑。
- 使用模板： 如果你的架构使用标准模式，请为常见部分创建模板。这可以加快建模速度并确保一致性。
- 与代码关联： 在可能的情况下，将图表元素与实际的代码仓库关联起来。这可以确保可追溯性。
- 限制深度： 避免过度嵌套图表。如果某个部分需要自己的CSD，请链接到单独的图表，而不是将其内联绘制。这样可以保持主视图的可读性。
关键元素分解表 📊
为了快速参考，以下是您将遇到的核心元素的概要。
| 元素 | 符号 | 用途 |
|---|---|---|
| 部分 | 带有类名的矩形 | 表示复合体内部分类器的一个实例。 |
| 角色 | 接口符号或奶嘴符号 | 定义部分所暴露或需要的行为。 |
| 端口 | 边缘上的小方块 | 分类器边界上的交互点。 |
| 连接器 | 带箭头的线 | 连接交互点以实现数据流动。 |
| 协作 | 带标签的虚线框 | 将部分和连接器分组，以定义特定的交互上下文。 |
关于结构完整性的最后思考 🏛️
构建健壮的软件不仅仅是编写代码。它还需要清晰地了解各个部分如何组合在一起。UML复合结构图提供了一种严谨的方式来记录这一愿景。它迫使架构师直面内部复杂性。
通过关注部分、角色和端口，您将创建一个既详细又可维护的模型。它降低了隐藏依赖的风险，并明确了数据在系统中的流动方式。虽然绘制需要额外努力，但为开发团队带来的清晰度值得这项投入。
从今天开始，将此技术应用于您最复杂的类。您会发现，架构的内部连接将如同外部接口一样清晰。
