看看 CabloyJS 工作流引擎是如何实现 Activiti 边界事件的

CabloyJS 内置工作流引擎的基本介绍

1. 由来

众所周知，NodeJS 作为后端开发语言和运行环境，支持高并发、开发效率高，有口皆碑，但是大多用于数据 CRUD 管理、中间层聚合和中间层代理等工具场景，很少深入到业务领域的核心。有许多用 NodeJS 开发的最小可用产品（ MVP ）最终会另起炉灶重构，这是原因之一

究其根源，NodeJS 作为业务开发平台，还缺少许多核心的基础构件，NodeJS 工作流引擎便是其一。CabloyJS 从 4.0 版本起，重点开发了 NodeJS 工作流引擎，并作为内置的基础核心模块（同样是开源、免费），近一步拓展了 NodeJS 在后端的应用场景，为深入研发各类商业业务逻辑，提供了基础支撑

2. 特点

1. 更简便的配置：采用JSON进行流程定义的配置，告别XML配置文件的冗杂

2. 更清晰的架构：基于分层机制采用多个核心模块来搭建工作流引擎的架构，让工作流不再神秘，源码也不再叠床架屋

边界事件的概念与实现

1. Activiti 的边界事件

在Activiti流程引擎中，可以通过边界事件向流程节点附加特定用途的处理逻辑。比如，向流程节点增加一个定时器边界事件，如果节点在指定的时间内没有执行完毕，就会自动触发边界事件

2. CabloyJS 的节点行为

由于边界事件的本质是向流程节点附加特定的行为。 因此，CabloyJS 采用节点行为机制来实现类似Activiti中边界事件的功能

CabloyJS 为节点行为设计了统一的开发规范，允许第三方开发自定义的节点行为类型。CabloyJS 系统本身也将根据业务的实际需求以及优先级，持续增加内置的节点行为类型

3. 边界事件与节点行为的区别

1. 配置简洁：

   1. 在 Activiti 中，边界事件由单独的 XML 节点配置，并与活动节点建立连接

   2. 在 CabloyJS 中，直接在活动节点的 JSON 配置中添加行为配置，使得流程定义文件更加简洁、紧凑

2. 开发简便：

   1. 在 Activiti 中，提供了几个内置的边界事件，大多数场景都是基于这些内置边界事件做开发，却鲜有人尝试开发自定义的边界事件

   2. 在 CabloyJS 中，提供了非常清晰的编程接口，不仅内置常用的节点行为，而且允许第三方非常便捷的开发自定义的节点行为类型

演示

下面的动图演示了：

1. 向审核节点增加超时行为，系统自动分配了一个颜色，用于区分不同的行为

2. 设置行为的配置：持续时间

3. 从行为拉出一根转移线，指向起草节点

4. 效果：当超过指定的时间还没有审核完毕，就会自动转向起草节点

如果要进一步研究如何创建一个完整的流程定义，请参见：

1. 演示：CMS 审批工作流

2. 演示：CMS 审批工作流(可视化编辑)

JSON 规范

为了支持节点行为，在原有流程定义的基础之上，同时扩展了活动节点 JSON 规范和转移线 JSON 规范，参见：

1. 流程定义 JSON 规范

2. 活动节点 JSON 规范

3. 转移线 JSON 规范

1. 活动节点 JSON 规范

在常规的活动节点 JSON 规范中增加了behaviors属性。由于一个节点可以附加多个行为，因此behaviors是一个数组

{
  id: 'activity_1',
  name: 'Review',
  type: 'activityUserTask',
  options: {
    assignees: {
      vars: 'flowUser',
    },
  },
  behaviors: [
    {
      id: 'behavior_1',
      name: 'Overtime',
      type: 'overtime',
      color: '#FF3B30',
      options: {
        cancelActivity: true,
        timeDuration: 3000,
      },
    },
  ],
},

• behavior

2. 转移线 JSON 规范

在常规的转移线 JSON 规范中增加了behavior属性，用于标识该转移线所对应的行为 Id

{
  id: 'edge_3',
  source: 'activity_1',
  target: 'startEvent_1',
  behavior: 'behavior_1',
},

相关链接

• CabloyJS 网站: https://cabloy.com/

• NodeJS 工作流引擎文档：https://cabloy.com/zh-cn/articles/flow-introduce.html

• GitHub 源码仓库: https://github.com/zhennann/cabloy