1. 从一开始就要搞清楚的事:系统级活动图里的对象节点,到底画的是什么
先说我自己的经历。前两年带一个团队做订单中台重构,评审活动图的时候,我发现一个特别普遍的现象:大部分同学画活动图,画出来的是清一色的控制流——一个圆角矩形接一个圆角矩形,箭头连来连去,动作倒是清清楚楚,但数据在哪儿流动、哪个环节拿出什么、放进什么,图上完全看不出来。
问他们,回答基本是两种:一种说"对象节点?不就是那个矩形加个名字嘛,我画了啊",另一种说"画那个干嘛,流程图嘛,把流程走通就行了"。
这两种说法,第一个是没搞懂对象节点在小粒度动作图里和系统级模型里的差异,第二个是压根没意识到缺了对象节点,活动图就只剩骨架没有血肉。
系统级的Activity Diagram,通常用来描述一个业务模块、一个子系统甚至跨系统之间的完整流程。在这个层级,对象节点要回答的不是"这个动作内部怎么处理数据",而是"这个动作从谁那里拿到什么、做完之后把什么交给了谁"。换句话说,它是模块与模块之间、动作与动作之间的数据契约。
打个比方,控制流是流水线上的传送带,对象节点就是传送带上流转的工件。你光画传送带不画工件,工人站在哪个工位干什么都看不出来;光画工件不画传送带,那也不知道工件按什么顺序流转。两者缺一不可,但在系统级建模时,大多数人缺的是后者。
这篇文章就把系统级活动图里的对象节点怎么表示这件事彻底讲清楚。从五种基础形态讲到系统级建模的实际用法,再给你一套可以直接拿走的命名规范和踩坑清单,适合正在做系统设计、画架构图、写技术方案,以及带团队做方案评审的人参考。
1.1 对象节点快速扫盲:它不是一个符号,是一族符号
先明确一个基础概念,免得后面混淆。在UML 2.5规范里,对象节点(ObjectNode)是一个抽象父类,它下面有一堆具体子类。系统级活动图里你真正会遇到的,主要是下面这几种:
| 具体类型 | 图形符号 | 核心语义 |
|---|---|---|
| Pin(输入/输出针脚) | 小方块,贴在动作旁边 | 动作的输入参数和输出结果 |
| CentralBufferNode(中央缓冲节点) | 矩形,内部写名称 | 动作之间传递数据的暂存区 |
| DataStoreNode(数据存储节点) | 矩形,名称前加^datastore关键字 | 持久化存储,比如数据库表 |
| ActivityParameterNode(活动参数节点) | 矩形,位于活动图边界或顶部 | 整个活动的输入端和输出端 |
| 扩展流(FlowPort等) | 矩形/小方块 | 连续数据流的传输,多用于嵌入式实时系统 |
这里最容易犯的错,就是把它们统一叫"对象节点",然后画的时候全画成一个样。不同形态对应完全不同的语义,错了,评审的时候一眼就能被挑出来。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 五种符号在系统级场景下分别怎么用:从订单中台的实际案例说起
系统级活动图不是教科书练习,它得能承载真实的系统设计。我拿一个电商订单中台的简化场景来说明,这个场景我实际画过很多版,用来带新人最合适。
2.1 Pin(输入/输出针脚):表达动作级数据进出
Pin在系统级活动图里用得其实不多,因为系统级动作的粒度比较粗。但当某个动作有明显的输入参数和输出结果时,Pin是唯一正确的表达方式。
比如订单创建动作,它接收"购物车数据"和"用户ID"两个输入,输出"订单对象"。图里你会看到:
code复制[用户ID] --(input)--> [创建订单动作] --(output)--> [待支付订单]
具体画法是,在动作框的左侧边缘贴两个小方块,分别标注用户ID、购物车数据,在右侧边缘贴一个小方块,标注待支付订单。这些都是Pin。
为什么系统级要用Pin而不是直接用线连到下一个动作?因为Pin表达了"这个动作确实消费了这些输入,并明确产生这些输出"。如果不画Pin,两个动作之间直接连线,别人就只能猜数据
