多实例实现会或签,依次审批
如果你去找 Activiti 的会或签解决方案,肯定会发现 Activiti 的多实例功能。
多实例就是一个节点在运行时产生多个实例,这些节点的配置大体上都是相似的,只有参数上可能有所不同,这些实例可以配置成串行执行或者并行执行。比如 UserTask 产生多个实例,每个实例只有负责人不同,会或签就是用这个实现的。
最简单的一个会签配置如下:
<!--会签配置--><userTaskid="someTask"name="Activiti is awesome!"activiti:assignee="${user}"><multiInstanceLoopCharacteristicsisSequential="false"activiti:collection="${userList}"activiti:elementVariable="user"/></userTask>
上面的配置用伪代码表示如下:
# userList 是列表类型的流程变量foruserinuserList: 用user作为任务负责人(assignee)执行UserTask
默认情况下只有当所有的实例都完成时,这个 UserTask 才会完成。所以上面这个配置其实就是会签,所有负责人同时进行任务,等到所有任务都完成时,才能结束这个 UserTask。
需要注意的是,因为 isSequential="false"
,所以这些实例都是并行执行的,也就是这些实例都是同时产生的。如果设置为 true,这些实例则会“依次”执行,也就是第一个负责人完成任务后,第二个实例才会产生,这样依次下去,所以只要将 isSequential
设置为 true
就可以实现依次审批了:
<!--依次审批配置--><userTaskid="someTask"name="Activiti is awesome!"activiti:assignee="${user}"><multiInstanceLoopCharacteristicsisSequential="true"activiti:collection="${userList}"activiti:elementVariable="user"/></userTask>
“或签”又该如何实现呢?multiInstanceLoopCharacteristics
还支持配置结束条件,通过结束条件的配置即可实现或签:
<!--或签配置--><userTaskid="someTask"name="Activiti is awesome!"activiti:assignee="${user}"><multiInstanceLoopCharacteristicsisSequential="false"activiti:collection="${userList}"activiti:elementVariable="user"><completionCondition>${nrOfCompletedInstances == 1}</completionCondition></multiInstanceLoopCharacteristics></userTask>
completionCondition
里面填写的就是结束条件,其中 nrOfCompletedInstances
是多实例节点的内置变量,表示已经完成实例数目,除此之外还有下面几个内置变量:
nrOfInstances
: 实例总数nrOfCompletedInstances
: 已完成实例总数nrOfActiveInstances
:当前活跃实例总数
通过这几个变量可以配置出更加丰富的结束条件,比如我可以配置一个 "半会签",即只要一半的人通过就行了:
<!--半会签配置--><userTaskid="someTask"name="Activiti is awesome!"activiti:assignee="${user}"><multiInstanceLoopCharacteristicsisSequential="false"activiti:collection="${userList}"activiti:elementVariable="user"><completionCondition>${nrOfCompletedInstances/nrOfInstances >= 0.5}</completionCondition></multiInstanceLoopCharacteristics></userTask>
除了 UserTask 可以多实例,Activiti 上还有好多节点支持多实例,配置也都是相似的:
- User Task
- Script Task
- Java Service Task
- Web Service Task
- Business Rule Task
- Email Task
- Manual Task
- Receive Task
- (Embedded) Sub-Process
- Call Activity
另外,多实例的这个概念与配置方法都是写在 BPMN 2.0 规范中的,而不是 Acitiviti 独有的,他们在 BPMN 的图形如下(在节点上有三条竖线表示并行,有三条横线表示串行):
所以使用这种配置方式,以后想切引擎也是非常方便的。
原理
多实例在代码上采用的是装饰器模式,使用 MultiInstanceActivityBehavior
里面包一个功能节点的 ActivityBehavior
,比如 UserTaskActivityBehavior
。MultiInstanceActivityBehavior
的两个子类,ParallelMultiInstanceBehavior
和 SequentialMultiInstanceBehavior
就分别代表并行多实例和串行多实例的逻辑。
并行的情况会给每一个实例生成一个 execution,当满足 completionCondition
时,恢复父 execution 的执行,并且删除它的所有子 execution(就是节点产生的多实例):
至于串行多实例,这整个一串实例共用一个子 execution:
如果原理部分看得比较蒙圈,建议先去看一下我的上一篇文章,然后再来看这里的原理就一目了然了。