【专业技能】程序员的软件工程素养之画好 UML 时序图

前言

笔者在本科的时候上过软件工程的专业课,也完成过类似的课堂作业,但是工作以后一直没怎么用上。碰巧前段时间有碰到一个复杂系统的部分功能设计,作为设计文档的一部分,时序图也被我拿起来派上用场了。

时序图通过描述对象之间发送消息的时间顺序显示多个对象之间的动态协作,同时它解释了一个系统中的不同部件之间,彼此是通过怎样的交互来实现某个功能,、以及特定场景下交互发生的顺序。


一、认识时序图

时序图(Sequence Diagram),又名序列图、循序图,是一种UML交互图。一般的软件开发都是为了支撑某个具体的业务,有时候业务的流程会比较复杂,涉及到多种角色,这时就可以使用时序图来梳理这个业务逻辑。这样会使业务看起来非常清晰,代码写起来也是水到渠成的事情。

1.1时序图元素

一般来说,我们在画时序图时会涉及到以下7种元素:

  • 角色(Actor)

    系统角色,可以是人或者其它系统、子系统,以一个小人图标表示。

  • 对象(Object)

    位于时序图的顶部,用一个矩形表示,对象的选择一般有以下三种:

    • 某个系统或者子系统的名称;
    • 涉及到的中间件的名称;
    • 涉及到具体的类和对象的名称。
  • 生命线(LifeLine)

    时序图中每个对象和底部中心都有一条垂直的虚线,这就是对象的生命线,以一条垂直的虚线表示。

  • 控制焦点(Activation)

    控制焦点代表时序图中在对象生命线上某段时期执行的操作,用一个很窄的矩形表示。

  • 消息(Message)

    表示对象之间发送的信息,可以分为以下三种类型:

    • 同步消息(Synchronous Message)

      消息的发送者把控制传递给消息的接收者,然后停止活动,等待接收者放弃或者返回控制,用来表示同步的意义。用一条实线和实心箭头来表示。

    • 异步消息(Asynchronous Message)

      消息发送者把信号传递给接收者,然后继续自己的活动,不等待接收者返回消息或控制,即异步消息的发送者和接收者是互不影响的。用一条实线和大于号表示。

    • 返回消息(Return Message)

      返回消息表示调用过程的返回,用虚线和小于号表示。

  • 自关联消息

    表示对象内方法的自调用或者调用对象内的另一个方法,用一个半闭合的矩形和下方实心箭头表示。

  • 组合片段

    组合片段用来解决交互执行的条件和方式,它允许在时序图中直接表示逻辑组件,用于通过指定条件或子进程的应用区域,为任何生命线的任何部分定义特殊条件和子进程。下面说明几个相对来说比较常见的组合片段:

    组合名称 含义说明
    ref 引用其它地方定义的组合片段
    alt 在一组特定行为中根据条件选择某个交互
    opt 表示一个可选的行为
    break 提供了和编程语言中与 break 类似的机制
    loop 说明交互片段会被重复执行

其中前 6 种是比较常用和重要的元素,最后的组合片段元素相对比较复杂。

1.2怎么使用

下面举一个用户调起支付宝的例子来说明上面提到的元素具体是怎么使用的。

调起支付宝支付时序图

注:调起支付的时序图可能没有全覆盖上面说的元素,下面一节的示例可能更加全面。


二、画好时序图

我本人一般是使用时序图来梳理业务逻辑的,碰上比较复杂的业务,需要几个中间件或者系统参与的时候,时序图能很好地展示各个系统和中间件的调用关系。

2.1一般步骤

为了画好时序图,我自己总结出了以下几个值得注意的步骤:

  1. 明确业务涉及的对象,一般是某个系统或者中间件,这很重要;
  2. 每个对象的生命线需要明确各自的控制焦点,即该系统或者中间件按照流程需要做的事情,比如后台一般增删改查、数据库读/写、MQ异步生产/消费等;
  3. 对象进行自调用时注意与页面的交互,是否涉及状态变更,是否涉及数据的入库和返回展示;
  4. 注意中间件的使用是异步or同步,异步的话注意与其它系统的关联,同时由于是异步,还可以着重判断一下异步的结果情况后再进行下一步;
  5. 组合片段的选择性使用,比较多的是 alt 和 opt,看页面是否可以选择性交互,或者看结果是否可以选择性操作。

2.2举个例子

下面我举一个实际项目的业务例子,主要是为系统用户发放获奖证书的流程,涉及到管理后台、消息队列、数据库和APP(即H5页面)这几个对象。流程如下:

  • 用户登录后台后新增/编辑获奖证书,选择用户进行发放,并将产生的数据持久化;
  • 发放时 MQ 生产者发送异步消息,无论消费是否成功都返回发送成功给前端;
  • MQ 消费发送过来的携带用户信息的消息,消费成功后将数据持久化在数据库;
  • H5 端经过页面交互后,获取上一步的数据库的数据进行前端展示。
发放获奖证书时序图

2.3推荐工具

  • Diagrams (原名draw.io)

    在线网址:https://app.diagrams.net/

    我个人是比较推荐使用 Diagrams (原名draw.io) 的,它是一款免费且开源的专业画图工具。它具有本地存储和离线使用的功能,同时也支持多人协作和多种文件格式的导入导出。

Diagrams 在线
  • processOn(不推荐)

    在线网址:https://www.processon.com/

    其实我最开始接触专业 UML 画图的工具是 processOn,功能强大且模板多,最主要是那个时候使用是免费的。但是这两年开始收费了:模板收费就算了,自己画也要收费,我就放弃了。当然,有付费意愿的朋友是可以试试的,应该可以满足你的大部分需求。

processOn

三、其它作用

开发人员掌握画图的技能可以将零散的知识碎片结构化,通过图形来结构化我们的思维模式,这样的好处是可以清晰的认识到自身对事物的理解和掌控程度。

  • 首先,在我们编码之前先做设计图,可以让自己对业务需求有一个较深的理解,避免自己一边写编码一边踩业务需求的坑。

  • 其次,可以降低同事之间的沟通理解成本,看图可能会比看代码更容易理解业务逻辑,也能够让非技术同事明白程序实现的真正逻辑。

  • 最后,程序的设计图,可以存档沉淀为公司宝贵的技术资源,优秀的设计图还可以共享给其他同事学习参考,实现真正的 "共同富裕"。


四、文章小结

到这里关于 UML 时序图的分享就告一段落了,如果文章有错误或不足,还请大家指正。或者大家有什么更好的 idea,也都欢迎在评论区讨论交流。

参考文章

热门相关:绝代疯少   盛华   妖夏   第一强者   走私大明