结构建模是稳健系统设计的基石。当你需要可视化分类器的内部架构，或展示各个部分如何协作形成整体时，UML复合结构图（CSD）提供了必要的深度。这种图不仅超越了简单的对象关系，还揭示了类或组件的内部运作机制，定义了其构建方式以及与环境的交互方式。
理解这种图对于需要定义复杂系统的架构师和工程师至关重要。它通过展示各部分的组装过程，弥合了静态结构与动态行为之间的差距。本指南将深入探讨与复合结构图相关的每一个元素、关系和最佳实践。
什么是复合结构图？🤔
复合结构图表示分类器的内部结构。它展示了构成分类器的各个部分、这些部分所扮演的角色，以及它们之间通信的接口。与专注于属性和方法的标准类图不同，CSD关注的是组合与连接。
当以下情况时，该图尤其有用：
- 设计具有多个内部模块的复杂子系统。
- 明确硬件与软件的边界。
- 定义系统架构中组件的组装方式。
- 可视化一个类如何由其他类构建而成。
该图提供了对元素的内部块或内部结构的清晰视图。它使你能够看到连接不同功能单元的内部连接路径。
图中的核心元素 🧱
要构建复合结构图，你必须理解其基本构成要素。每个元素在定义系统拓扑结构中都发挥着特定作用。以下是主要组件的分解说明。
1. 部分 🧩
部分表示复合结构中分类器的一个实例。它是整体的一个组成部分。部分是位于容器内部的物理或逻辑单元。你可以将部分理解为复合类作用域内特定类型的变量声明。
- 表示法： 一个带有名称和类型的矩形，通常放置在主容器内部。
- 示例： 在一个
汽车分类器中，你可能会有如下部分：发动机，类型为发动机以及车门类型为门列表.
2. 端口 🔌
端口是通信的入口和出口。一个部件不能直接与外部世界交互；它必须通过端口进行。端口定义了内部部件与外部环境或其他内部部件连接的交互点。
- 提供的接口： 一个向其他部件提供功能的端口。通常以棒棒糖图标表示。
- 需要的接口： 一个需要从其他部件获取功能的端口。通常以插座图标表示。
3. 连接器 🔗
连接器在端口之间建立通信路径。它们代表了允许数据、控制信号或物料在部件之间流动的连接。连接器确保部件不会成为孤立的孤岛，而是形成一个协调的系统。
- 装配连接器： 将一个需要的接口连接到一个提供的接口。
- 委托连接器： 将复合体外部端口的交互委托给内部部件的端口。
4. 角色 🎭
角色描述了部件参与连接时的视角。一个部件在不同的连接中可能扮演多个角色。例如，一个 网络卡 部件可能在一种连接中扮演 发送者 的角色，在另一种连接中则扮演 接收者 的角色。
可视化接口与交互 📊
接口对于将内部实现与外部使用解耦至关重要。复合结构图很大程度上依赖于接口定义来保持灵活性。
| 元素 | 符号 | 描述 |
|---|---|---|
| 部件 | 带标签的矩形 | 结构内包含的分类器的实例。 |
| 端口 | 零件边框上的小方块 | 零件与其他部分交互的边界。 |
| 提供接口 | 棒棒糖（棒上的圆圈） | 表示该端口提供服务。 |
| 需要接口 | 插座（半圆） | 表示该端口需要服务。 |
| 连接器 | 连接端口的线 | 在两个端口之间建立连接。 |
| 复合结构 | 大矩形 | 表示分类器的容器。 |
内部块图与复合结构图 🔄
在统一建模语言（UML）中，复合结构图与内部块图（IBD）之间常常存在混淆。尽管它们有相似之处，但其应用场景不同。
- 复合结构图： 关注于 分类器 结构。用于定义类或组件的内部结构。通常在设计阶段使用，以定义特定实体的架构。
- 内部块图： 关注于 块 结构。用于活动图或顺序图中，展示特定行为期间块之间的数据流。其性质更具动态性。
两种图表对零件和端口使用相似的符号，但其语义上下文不同。CSD 是静态结构建模，而 IBD 通常支持行为建模。
定义关系与依赖关系 🔗
建立正确的关联关系对于模型的完整性至关重要。必须确保依赖关系被准确反映，以避免循环逻辑或未定义行为。
使用与实现
接口定义了契约。当一个部件需要服务时，它使用一个使用关系。当一个部件提供服务时，它使用一个实现关系。这些关系明确了依赖的方向。
委托
委托是一种特定类型的连接器。它将复合结构的一个端口连接到内部部件的一个端口。这使得复合结构能够向外部世界暴露其内部部件的功能，而无需详细揭示内部拓扑结构。
例如，如果一个用户界面部件需要向一个处理器部件发送命令，复合类可能有一个端口，将此调用直接委托给处理器。这在保持封装性的同时，实现了必要的通信。
建模最佳实践 ✅
为了创建能够实现其目的的有效图表，请遵循以下指南。
- 限制复杂性： 单个图表不应包含过多的部件。如果结构过于密集，应考虑将其拆分为多个图表，或使用子复合体。
- 命名一致性： 为部件和端口使用清晰的名称。避免使用像
部件1或连接1这样的通用名称。应使用领域特定的术语。 - 清晰定义接口： 不要假设接口是已知的。应明确定义所提供的或需要的操作或信号。
- 使用角色： 如果一个部件在不同上下文中被重用，应定义角色以显示其在每个连接中的特定功能。
- 验证连接性： 确保每个所需的端口都有一个通过连接器连接的匹配提供的端口。未连接的所需端口表示存在缺失的依赖关系。
常见陷阱与故障排除 ⚠️
即使是经验丰富的建模人员也会遇到问题。了解常见错误有助于保持模型质量。
过度建模
在复合结构中展示每一个属性和方法很容易，但这并不必要。应专注于结构连接。属性通常更适合在类图或部件详细信息中表示。
混淆部件与实例
CSD中的一个部件是一个结构组件，不一定是运行时实例。虽然相关，但这种区别很重要。CSD定义了蓝图，运行时环境创建实例。
嵌套结构
虽然允许嵌套部件，但过度嵌套会使图表难以阅读。如果你发现自己在层层嵌套部件，应考虑扁平化层次结构，或为嵌套组件创建单独的图表。
与其他UML图的集成 📐
复合结构图并非孤立存在。它与其他图类型交互，以提供完整的系统视图。
- 类图： CSD提供了类图中定义的类的内部视图。类图定义了静态属性和操作，而CSD则定义了该类的组装方式。
- 部署图： CSD有助于定义将要部署的软件组件。它在映射到硬件节点之前，明确了内部组成。
- 顺序图： CSD中定义的端口成为交互序列中的参与者。你可以验证顺序图中的消息流是否与CSD中的端口定义一致。
高级场景 🚀
复杂系统通常需要高级建模技术。以下是一些CSD表现突出的场景。
软硬件协同设计
在设计嵌入式系统时，你通常同时拥有软件模块和硬件芯片。CSD可以建模这种混合结构。你可以定义一个FPGA部件，以及一个驱动软件部件，展示它们如何通过端口连接。
子系统分解
大型系统被划分为子系统。CSD允许你将子系统定义为包含其他子系统的复合结构。这种分层方法有助于管理企业级架构中的复杂性。
有状态组件
有时部件需要维持状态。虽然CSD主要展示结构，但涉及的部件可以与状态机图关联。这展示了内部结构如何管理状态转换。
常见问题 🤔
我可以用复合结构图来表示动态行为吗？
不。此图仅用于结构建模。它展示了系统的构建方式，而非其随时间的行为。若需描述行为，请使用顺序图、活动图或状态机图。
如何处理一个端口上的多个接口？
一个端口可以支持多个接口。你可以在同一个端口上绘制多个奶嘴状符号或插座，或者使用一个端口并添加标签说明其支持多个接口。确保连接器连接到所需的特定接口。
此图在SysML中是否受支持？
是的。SysML的内部块图源自UML的复合结构图。尽管SysML更侧重于IBD，但部件、端口和连接器的概念保持一致。
部件和属性之间的区别是什么？
在类的上下文中，属性是属性；在复合结构图的上下文中，部件是结构组件。它们相似，但用于不同的建模场景。部件暗示了组合关系。
我需要展示所有部件吗？
不需要。你可以省略与当前架构视图无关的部件。但省略关键部件可能导致对系统依赖关系的混淆。仅展示实现特定设计目标所必需的内容。
如何表示数据流？
数据流由连接器隐含表示。若需展示特定数据类型，可将数据类型名称标注在连接器上。但对于详细的数据流，顺序图或活动图更为合适。
部件可以被聚合吗？
可以。部件可以通过聚合关系连接。这表示部件可以在不依赖复合结构的情况下独立存在，具体取决于所定义的基数和关系类型。
总结 📝
UML复合结构图是定义复杂系统内部架构的强大工具。通过将分类器分解为部件、端口和连接器，可以清晰地了解组件之间的交互方式。这种清晰性有助于减少实现和测试过程中的歧义。
关键要点包括：
- 部件表示结构内部的组件。
- 端口定义了交互点。
- 连接器连接端口以实现通信。
- 接口确保组件之间的解耦。
- 一致的建模实践可防止结构错误。
当正确应用时，此图有助于架构师、开发人员和测试人员之间的更好协作。它作为内部设计的契约，确保各方都理解系统的组装方式。在创建这些图时，应注重清晰性、准确性和相关性，以最大化其在工程工作流程中的价值。
