理解复杂系统的内部架构对于稳健的软件设计至关重要。虽然类图提供了对象及其关系的高层次视图，但它们通常无法捕捉单个分类器的详细内部组成。这正是“复合结构图发挥作用的关键所在。本指南将带你完成创建这些图表的关键步骤，确保你的系统模型精确、可维护且清晰。

🔍 什么是复合结构图？

复合结构图是一种专门的UML图，用于展示分类器的内部结构。它揭示了类或组件内部各部分之间的连接方式及其相互作用。可以将其视为系统元素的X光透视图，展示其内部运作，而不仅仅是外部接口。

• 关注点：内部结构与委托。
• 作用范围：仅针对单个分类器（如类或组件）。
• 用途：展示各部分如何连接以实现整体功能。

与列出属性和方法的标准类图不同，该图专注于内部各部分之间的关系。在由多个相互作用的子单元组成的单一逻辑单元的复杂系统建模中，它尤其有用。

🧩 核心元素与概念

要绘制准确的图表，必须理解其特定的构建模块。每个元素在定义内部拓扑结构中都发挥着独特作用。

1. 部分 🧱

部分表示由复合体拥有的分类器的实例。它是一种结构特征。当你定义一个部分时，实际上是在声明该复合体包含特定类型的对象。

• 符号表示：带有部分名称和类型的矩形。
• 作用：定义内部组件。

2. 端口 🚪

端口是复合体或其部分的独立交互点。它定义了内部组件如何与外部世界或其他内部组件连接。端口封装了接口，隐藏了内部实现细节。

• 符号表示：附着在部分或复合体上的小圆圈。
• 作用：定义交互点（提供的或需要的接口）。

3. 连接器 🔗

连接器用于连接端口。它们定义了各部分之间信息或控制的流动。连接器可以连接两个内部端口，一个内部端口与一个外部端口，或一个外部端口与一个部分。

• 符号表示： 连接端口的实线。
• 角色： 建立通信路径。

4. 交互使用 🔄

交互使用表示在结构内对特定交互（如顺序图）的使用。它允许你在不内联绘制的情况下对行为进行建模。

• 符号： 带有交互名称的矩形。

5. 执行环境 🌐

它定义了部件执行的环境。有助于在结构内对部署和运行时上下文进行建模。

📊 对比：类图 vs. 组合结构图

理解何时使用哪种图对于清晰建模至关重要。请使用下面的表格来区分它们的目的。

特性	类图	组合结构图
关注点	类的静态结构	单一分类器的内部结构
详细程度	高层次的属性和方法	低层次的部件和内部连接
关系	聚合、关联、继承	委托、组合、内部布线
用例	数据库模式、总体架构	组件内部结构、硬件子系统

🛠️ 分步指南：如何绘制该图

创建组合结构图需要有条不紊的方法。遵循以下步骤以确保准确性和清晰性。

步骤 1：识别分类器

首先选择您想要分析的特定类或组件。这将成为您图表的主要容器。问自己：“这个特定单元需要展示的内部复杂性是什么？”如果该单元很简单，类图可能就足够了。如果它具有内部逻辑或多个子组件，则继续下一步。

步骤 2：定义各个部分

将分类器分解为其组成部分。这些是构成整体的各个对象。清晰地列出它们。

• 识别依赖关系：这部分运行需要什么？
• 定义类型：为每个部分分配一个具体的类或接口。
• 分配名称：在复合体的上下文中，为每个部分分配一个唯一的标识符。

步骤 3：确定接口（端口）

针对每个部分，决定它如何交互。它是否需要从其他部分获取服务？它是否向外部世界提供服务？为这些交互创建端口。

• 提供的接口：在端口上绘制一个“棒棒糖”符号。
• 所需的接口：在端口上绘制一个“插座”符号。
• 连接性：确保每个所需的接口都有一个对应的提供的接口。

步骤 4：建立连接（连接器）

在端口之间绘制线条，以显示数据或控制流的路径。这就是系统的“布线”。

• 内部连接：将同一复合体内的各个部分相互连接。
• 委托：将内部部分的端口连接到复合体的外部端口。这表明复合体将请求委托给该部分。

步骤 5：优化与审查

结构绘制完成后，对其进行一致性审查。检查所有必需的接口是否均已满足。确保不存在可能导致运行时问题的循环依赖。确认符号使用符合标准的 UML 规范。

💡 实际示例：支付处理系统

让我们将这些知识应用于一个实际场景。考虑一个PaymentProcessor类。这个类不仅仅是简单的计算器；它负责验证、货币转换和交易日志记录。

场景分解

• 复合体： 支付处理器
• 第一部分： 验证器（检查卡片信息）
• 第二部分： 转换器（处理货币）
• 第三部分： 记录器（记录交易）

连接

1. 该验证器需要一个卡片检查器 接口。
2. 该转换器需要一个汇率 接口。
3. 该记录器提供一个日志访问 接口。
4. 该支付处理器公开一个处理支付 端口。

在图中，该支付处理器 端口委托给 验证器 和 转换器。该 验证器 连接到 转换器 如果验证依赖于货币转换。该 日志记录器 连接到主流程，以确保每笔交易都被记录。

⚠️ 需要避免的常见陷阱

即使经验丰富的建模人员在定义内部结构时也可能出错。了解这些常见错误可以节省审查过程中的时间。

• 过度复杂化图表： 不要展示每一个变量。应关注结构化交互，而非数据存储细节。
• 忽略接口： 没有端口和接口的图表只是若干方框的集合。应明确各部分之间的通信方式。
• 混用层级： 不要在同一视图中混用高层组件图与低层部件细节。保持范围一致。
• 忽视生命周期： 确保部件在复合体的生命周期内被正确创建和销毁。部件不应在没有适当管理的情况下超出复合体的生命周期。

🔗 与其他图表的集成

复合结构图并非孤立存在。它与其他UML图表相辅相成，构成你的工具箱的一部分。

与序列图

使用序列图来展示在复合结构图中定义的连接内部发生的动态行为。序列图展示的是 何时，而结构图展示的是 何处.

与组件图

组件图在更高层次上展示了系统架构。复合结构图则深入探讨了特定组件。使用组件图把握整体情况，使用复合结构图进行深入分析。

配合部署图

部署图展示物理节点，复合结构图展示逻辑部件。你可以将结构图中的部件映射到部署图中的节点，以理解物理分布情况。

📝 文档编写最佳实践

为确保你的图表对团队有用，请遵循这些文档标准。

• 使用清晰的标签：清晰命名每个端口和部件，避免使用“Part1”或“ObjectA”之类的通用名称。
• 将相关部件分组：视觉上将功能相关的部件分组，以提高可读性。
• 记录委托关系：明确标记哪些内部部件通过委托连接器处理外部请求。
• 版本控制：将这些图表视为代码。每当类的内部结构发生变化时，都要及时更新。
• 限制复杂度：如果一个类包含过多内部部件，应考虑将其拆分为多个较小的类，或使用子结构图。

🧠 高级概念：内部活动

有时，部件之间的交互涉及复杂逻辑。你可以在一个部件内嵌入活动图来展示这种行为，这被称为内部活动图。

• 触发：定义启动内部活动的事件。
• 流程：展示部件执行的动作序列。
• 输出：定义发送回连接器的结果。

这种详细程度仅适用于内部逻辑非平凡的复杂系统。

📈 维护与演进

软件是不断演进的。随着需求变化，你的类的内部结构很可能随之改变。复合结构图是一个持续更新的活文档。

• 重构：如果重构一个类，请立即更新图表。不要让模型脱离现实。
• 分解：如果某个部件变得过于复杂，它本身也可以成为一个复合部件。为该部件创建一个新的图表。
• 评审周期：在您的常规架构评审会议中包含这些图表。确保团队就内部连接达成一致。

🚀 概要

创建复合结构图是一种强大的方式，可以可视化软件组件的内部机制。它弥合了高层架构与底层实现细节之间的差距。通过定义部件、端口和连接器，您为开发人员提供了一张清晰的地图，帮助他们理解数据在系统内的流动方式。

请记住：

• 明确识别主要分类器。
• 定义所有内部部件及其类型。
• 使用端口指定交互点。
• 使用连接器将它们连接起来。
• 审查一致性与清晰性。

通过练习，绘制这些图表将成为您设计过程中的自然组成部分，从而打造出更健壮、更易维护的软件系统。