Skip to content

约 4 分钟阅读

UML 建模总览 ​

UML(Unified Modeling Language,统一建模语言)是一套用于表达软件结构和行为的图形语言。它的作用不是替代代码,也不是把所有设计都画成复杂图纸,而是在概念、模块、对象关系、调用流程和状态变化不容易用文字说明时,提供一套大家能共同阅读的表达方式。

在架构设计中,UML 最有价值的场景有三类。第一类是解释结构,例如一个订单聚合包含哪些对象、服务之间依赖怎样排列;第二类是解释流程,例如支付完成后订单、库存、履约之间怎样协作;第三类是解释状态,例如订单从待支付到已发货再到已完成,中间哪些动作可以触发状态变化。

UML 建模总览

常用图的分工 ​

类图适合表达静态结构。它能展示类、接口、属性、方法以及对象之间的关系,常用于说明领域模型、设计模式、模块内部对象结构。普通关联不表示所有权,只有明确标出的整体与部分关系才讨论组合或共享聚合;具体线型和判断方法见类图关系。

时序图适合表达对象之间按时间发生的交互。例如取消订单时,应用服务先核对服务端身份,再加载订单,最后按状态和版本条件提交;返回成功必须发生在事务提交后。图中的对象从左到右排列,时间从上往下推进,返回消息用虚线,异步消息需要明确标注。它尤其适合定位“谁先调用谁”“失败发生在哪一步”“同步调用和异步事件在哪里分界”。

活动图适合表达流程分支。审批、结算、发货、退款这类有条件判断和多条路径的业务,用活动图可以把正常路径、异常路径、并行处理和结束条件画清楚。它更像流程图,但语义更标准。

状态机图适合表达对象生命周期。订单、工单、保单、任务这些对象的状态较多时,只写状态枚举很容易漏掉非法流转。状态机图能清楚表达“什么事件可以把对象从一个状态推到另一个状态”。

用例图适合表达系统边界和参与者目标。它不适合承载细节设计,更适合需求早期说明某类用户能完成哪些业务动作。组件图、部署图更偏架构层,用来说明模块、服务、节点、运行环境之间的关系。

选择图示的方式 ​

画 UML 时应先问要解决哪类沟通问题。要说明领域对象关系,用类图;要说明一次请求的调用顺序,用时序图;要说明业务流程分支,用活动图;要说明状态变化,用状态机图;要说明系统对外提供的能力,用用例图;要说明服务和部署关系,用组件图或部署图。

图不宜追求全量。一个图只表达一个层次的问题:领域模型图不混入数据库表结构,时序图不塞进所有异常分支,部署图不展开每个类。正常路径与失败路径可以拆图,但不能让省略的提交失败、重试或补偿变成默认成功。片段图要写清起点、终点和省略范围。

和 DDD 的关系 ​

DDD 提供建模思想,UML 提供表达工具。限界上下文可以用上下文映射图表达,聚合内部结构可以用类图表达,领域事件协作可以用时序图表达,订单生命周期可以用状态机图表达。两者并不绑定,但在复杂业务系统中经常配合使用。

例如订单上下文中,类图说明 Order、OrderLine、Money 的关系;时序图说明“接受已核验的支付事实”怎样更新订单并写入 Outbox;状态机图说明待付款订单接受付款或取消的条件。已经取消后才收到收款事实,需要核对或退款流程,不能直接把所有事件都连到 Paid。具体实现见 DDD 订单支付实践,本地事务与远程支付的边界也在该页展开。

从图落到验证 ​

以“待付款订单允许取消”为例,类图回答取消行为属于哪个对象;时序图回答服务端在哪一步检查租户、订单归属和提交结果;状态机图回答已支付时是否允许同一个取消动作。这三个答案应该一致。若状态图禁止已支付取消,而 SQL 只按订单编号更新,图并不能保护数据,需要把状态和版本条件落实到提交语句。

评审时沿着一个具体订单逐步演算,再加入付款与取消竞争、保存失败和客户端重试。图中的每个成功箭头都应能对应到可观察的结果,例如影响行数、事务提交记录或任务状态。仅把类名与状态名画齐,不足以证明流程正确。

绘图检查 ​

一张可发布的 UML 图应能独立解释核心关系。类图里的箭头要能区分依赖、关联、聚合、组合、继承和实现;时序图里的调用顺序要和真实代码或目标设计一致;活动图的分支条件要能读出业务判断;状态机图不能只列状态,还要写明触发事件。

如果一张图需要大量口头补充才能理解,说明图中层次混杂、命名不清或关系符号使用随意。此时应先缩小范围,只保留当前段落真正要解释的结构或流程。

别急,先让缓存热一下。