执行前触发。
TASK_COMPLETED 任务已经完成。本事件在 ENTITY_DELETE 事件前分
发。若该任务是流程的一部分,本事件会在流程前进之
前触发,并且会跟随一个 ACTIVITY_COMPLETE 事
件,指向代表该任务的节点。
org.flowable…FlowableEntityEvent
PROCESS_CREATED 流程实例已经创建。已经设置所有的基础参数,但还未
设置变量。
org.flowable…FlowableEntityEvent
PROCESS_STARTED 流程实例已经启动。在启动之前创建的流程时分发。
PROCESS_STARTED事件在相关的
ENTITY_INITIALIZED事件,以及设置变量之后分发。
org.flowable…FlowableEntityEvent
PROCESS_COMPLETED 流程实例已经完成。在最后一个节点的
ACTIVITY_COMPLETED 事件后分发。当流程实例没
有任何路径可以继续时,流程结束。
org.flowable…FlowableEntityEvent
PROCESS_COMPLETED_WITH_TERMINATE_END
_EVENT
流程已经到达终止结束事件(terminate end event)并结
束。
org.flowable…
FlowableProcessTerminatedEvent
PROCESS_CANCELLED 流程已经被取消。在流程实例从运行时中删除前分发。
流程实例由API调
用RuntimeService.deleteProcessInstance取
消。
org.flowable…FlowableCancelledEvent
MEMBERSHIP_CREATED 用户已经加入组。本事件包含了相关的用户和组的id。 org.flowable…FlowableMembershipEvent
MEMBERSHIP_DELETED 用户已经从组中移出。本事件包含了相关的用户和组的
id。
org.flowable…FlowableMembershipEvent
MEMBERSHIPS_DELETED 组的所有用户将被移出。本事件在用户移出前抛出,因
此关联关系仍然可以访问。因为性能原因,不会再为每
个被移出的用户抛出 MEMBERSHIP_DELETED 事件。
org.flowable…FlowableMembershipEvent
事件名事件名 称称 说说明明 事件事件 类类
引擎中所有的 ENTITY_\* 事件都与实体关联。下表列出每个实体分发的实体事件:
ENTITY_CREATED, ENTITY_INITIALIZED, ENTITY_DELETED: 附件(Attachment),备注(Comment),部署(Deployment),执行(Execution),组(Group),身份关
联(IdentityLink),作业(Job),模型(Model),流程定义(ProcessDefinition),流程实例(ProcessInstance),任务(Task),用户(User)。
ENTITY_UPDATED: 附件,部署,执行,组,身份关联,作业,模型,流程定义,流程实例,任务,用户。
ENTITY_SUSPENDED, ENTITY_ACTIVATED: 流程定义,流程实例/执行,任务。
3.18.7. 附加信息附加信息
监监听器只听器只会响应会响应其所在引擎分其所在引擎分发发的事件。的事件。因此如果在同一个数据库上运行不同的引擎,则只有该监听器注册的引擎生成的事件,才会分发给该监听器。其他引擎生成的事件
不会分发给这个监听器,而不论这些引擎是否运行在同一个JVM下。
某些事件类型(与实体相关)暴露了目标实体。按照事件类型的不同,有些实体不能被更新(如实体删除事件中的实体)。如果可能的话,请使用事件暴露
的EngineServices来安全地操作引擎。即使这样,更新、操作事件中暴露的实体仍然需要小心。
历史不会分发实体事件,因为它们都有对应的运行时实体分发事件。
4. Flowable API
4.1. 流程引擎流程引擎API与服与服务务
引擎API是与Flowable交互的最常用手段。总入口点是ProcessEngine。像配置章节中介绍的一样,ProcessEngine可以使用多种方式创建。使用ProcessEngine,可以获得
各种提供工作流/BPM方法的服务。ProcessEngine与服务对象都是线程安全的,因此可以在服务器中保存并共用同一个引用。
1
2
3
4
5
6
7
8
9
10
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
ManagementService managementService = processEngine.getManagementService();
IdentityService identityService = processEngine.getIdentityService();
HistoryService historyService = processEngine.getHistoryService();
FormService formService = processEngine.getFormService();
DynamicBpmnService dynamicBpmnService = processEngine.getDynamicBpmnService();
在ProcessEngines.getDefaultProcessEngine()第一次被调用时,将初始化并构建流程引擎,之后的重复调用都会返回同一个流程引擎。可以通
过ProcessEngines.init()创建流程引擎,并由ProcessEngines.destroy()关闭流程引擎。
ProcessEngines会扫描flowable.cfg.xml与flowable-context.xml文件。对于flowable.cfg.xml文件,流程引擎会以标准Flowable方式构建引
擎:ProcessEngineConfiguration.createProcessEngineConfigurationFromInputStream(inputStream).buildProcessEngine()。对
于flowable-context.xml文件,流程引擎会以Spring的方式构建:首先构建Spring应用上下文,然后从该上下文中获取流程引擎。
所有的服务都是无状态的。这意味着你可以很容易的在集群环境的多个节点上运行Flowable,使用同一个数据库,而不用担心上一次调用实际在哪台机器上执行。不论在哪个
节点执行,对任何服务的任何调用都是幂等(idempotent)的。
RepositoryService很可能是使用Flowable引擎要用的第一个服务。这个服务提供了管理与控制部署(deployments)与流程定义(process definitions)的操作。在这
里简单说明一下,流程定义是BPMN 2.0流程对应的Java对象,体现流程中每一步的结构与行为。部署是Flowable引擎中的包装单元,一个部署中可以包含多个BPMN 2.0 XML
文件及其他资源。开发者可以决定在一个部署中包含的内容,可以是单个流程的BPMN 2.0 XML文件,也可以包含多个流程及其相关资源(如’hr-processes’部署可以包含所有
与人力资源流程相关的的东西)。RepositoryService可用于部署这样的包。部署意味着将它上传至引擎,引擎将在储存至数据库之前检查与分析所有的流程。在部署操作
后,可以在系统中使用这个部署包,部署包中的所有流程都可以启动。
此外,这个服务还可以:
查询引擎现有的部署与流程定义。
暂停或激活部署中的某些流程,或整个部署。暂停意味着不能再对它进行操作,激活刚好相反,重新使它可以操作。
获取各种资源,比如部署中保存的文件,或者引擎自动生成的流程图。
获取POJO版本的流程定义。它可以用Java而不是XML的方式查看流程。
与提供静态信息(也就是不会改变,至少不会经常改变的信息)的RepositoryService相反,RuntimeService用于启动流程定义的新流程实例。前面介绍过,流程定义中
定义了流程中不同步骤的结构与行为。流程实例则是流程定义的实际执行过程。同一时刻,一个流程定义通常有多个运行中的实例。RuntimeService也用于读取与存储流程
变量。流程变量是流程实例中的数据,可以在流程的许多地方使用(例如排他网关经常使用流程变量判断流程下一步要走的路径)。RuntimeService还可以用于查询流程实
例与执行(Execution)。执行也就是BPMN 2.0中 'token' 的概念。通常执行是指向流程实例当前位置的指针。最后,还可以在流程实例等待外部触发时使
用RuntimeService,使流程可以继续运行。流程有许多等待状态(wait states),RuntimeService服务提供了许多操作用于“通知”流程实例:已经接收到外部触发,
流程实例可以继续运行。