事件等简介摘抄自官方文档
*后台服务基于Springboot2 + Activiti6,整合文章请参考:https://blog.csdn.net/yy756127197/article/details/101211510 不需要流程设计器就排除3,4步骤 *
1. 简介
1.1 事件(Event)
事件用来表明流程的生命周期中发生了什么事。 事件总是画成一个圆圈。 在BPMN 2.0中, 事件有两大分类:捕获(catching) 或 触发(throwing) 事件。
- 捕获(Catching):当流程执行到事件, 它会等待被触发。触发的类型是由内部图表或XML中的类型声明来决定的。 捕获事件与触发事件在显示方面是根据内部图表是否被填充来区分的(白色的)。
- 触发(Throwing):当流程执行到事件, 会触发一个事件。触发的类型是由内部图表或XML中的类型声明来决定的。 触发事件与捕获事件在显示方面是根据内部图表是否被填充来区分的(被填充为黑色)。
1.2 事件定义
事件定义决定了事件的语义。如果没有事件定义,这个事件就不做什么特别的事情。 没有设置事件定义的开始事件不会在启动流程时做任何事情。如果给开始事件添加了一个事件定义 (比如定时器事件定义)我们就声明了开始流程的事件 "类型 " (这时定时器事件监听器会在某个时间被触发)。
1.3 定时器事件定义
定时器事件是根据指定的时间触发的事件。可以用于 开始事件,中间事件 或 边界事件
定时器定义必须下面介绍的一个元素:
- timeDate。使用 ISO 8601 格式指定一个确定的时间,触发事件的时间。示例:
<timerEventDefinition>
<timeDate>2011-03-11T12:13:14</timeDate>
</timerEventDefinition>
- timeDuration。指定定时器之前要等待多长时间, timeDuration可以设置为timerEventDefinition的子元素。 使用ISO 8601规定的格式 (由BPMN 2.0规定)。示例(等待10天)。
<timerEventDefinition>
<timeDuration>P10D</timeDuration>
</timerEventDefinition>
- timeCycle。指定重复执行的间隔, 可以用来定期启动流程实例,或为超时时间发送多个提醒。 timeCycle元素可以使用两种格式。第一种是 ISO 8601 标准的格式。示例(重复3次,每次间隔10小时):
<timerEventDefinition>
<timeCycle>R3/PT10H</timeCycle>
</timerEventDefinition>
另外,你可以使用cron表达式指定timeCycle,下面的例子是从整点开始,每5分钟执行一次:
0 0/5 * * * ?
你可以在定时器事件定义中使用表达式,这样你就可以通过流程变量来影响那个定时器定义。 流程定义必须包含ISO 8601(或cron)格式的字符串,以匹配对应的时间类型。
<boundaryEvent id="escalationTimer" cancelActivity="true" attachedToRef="firstLineSupport">
<timerEventDefinition>
<timeDuration>${duration}</timeDuration>
</timerEventDefinition>
</boundaryEvent>
2. 定时器边界事件
2.1 简介
定时边界事件就是一个暂停等待警告的时钟。当流程执行到绑定了边界事件的环节, 会启动一个定时器。定时器边界事件存在可中断与不可中断两类,可以为boundaryEvent元素设置cancelActivity属性,如果设置为true,那么原来的执行流将会被中断,设置为false,则原来的执行流仍然存在。定时器边界事件在一些限时场景比较合适,例如:一个任务先是由初级工程师处理,当初级工程师1分钟后还没处理完成,就交给高级工程师处理。
2.2 流程设计
设置
说明
PT1M:一分钟后
流程图
流程文件bpmn
<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/processdef">
<process id="timerBoundary" name="timerBoundary" isExecutable="true">
<documentation>timerBoundary</documentation>
<startEvent id="startEvent1"></startEvent>
<userTask id="task1" name="初级工程师" activiti:assignee="test1">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://activiti.com/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-08B0BFEC-473C-4E0E-960B-48CF442670F3" sourceRef="startEvent1" targetRef="task1"></sequenceFlow>
<endEvent id="sid-8EE7BE60-47D7-4130-B64F-10B5C37C0C2A"></endEvent>
<sequenceFlow id="sid-DC9537E0-935E-4A59-AACE-196C7705612F" sourceRef="task1" targetRef="sid-8EE7BE60-47D7-4130-B64F-10B5C37C0C2A"></sequenceFlow>
<userTask id="task2" name="高级工程师" activiti:assignee="test2">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://activiti.com/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-3D34402A-FC77-4520-B40C-846BCA2C8727" sourceRef="sid-FFADB46B-D219-4BAC-86B2-73C1D3045169" targetRef="task2"></sequenceFlow>
<sequenceFlow id="sid-AEAE5FF5-69DF-4C54-B639-5A539E8A348B" sourceRef="task2" targetRef="sid-8EE7BE60-47D7-4130-B64F-10B5C37C0C2A"></sequenceFlow>
<boundaryEvent id="sid-FFADB46B-D219-4BAC-86B2-73C1D3045169" attachedToRef="task1" cancelActivity="true">
<timerEventDefinition>
<timeDuration>PT1M</timeDuration>
</timerEventDefinition>
</boundaryEvent>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_timerBoundary">
<bpmndi:BPMNPlane bpmnElement="timerBoundary" id="BPMNPlane_timerBoundary">
<bpmndi:BPMNShape bpmnElement="startEvent1" id="BPMNShape_startEvent1">
<omgdc:Bounds height="30.0" width="30.0" x="135.0" y="115.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="task1" id="BPMNShape_task1">
<omgdc:Bounds height="80.0" width="100.0" x="300.0" y="90.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-8EE7BE60-47D7-4130-B64F-10B5C37C0C2A" id="BPMNShape_sid-8EE7BE60-47D7-4130-B64F-10B5C37C0C2A">
<omgdc:Bounds height="28.0" width="28.0" x="555.0" y="116.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="task2" id="BPMNShape_task2">
<omgdc:Bounds height="80.0" width="100.0" x="300.0" y="255.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-FFADB46B-D219-4BAC-86B2-73C1D3045169" id="BPMNShape_sid-FFADB46B-D219-4BAC-86B2-73C1D3045169">
<omgdc:Bounds height="31.0" width="31.0" x="336.73857548837253" y="154.79435879070542"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="sid-DC9537E0-935E-4A59-AACE-196C7705612F" id="BPMNEdge_sid-DC9537E0-935E-4A59-AACE-196C7705612F">
<omgdi:waypoint x="400.0" y="130.0"></omgdi:waypoint>
<omgdi:waypoint x="555.0" y="130.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-AEAE5FF5-69DF-4C54-B639-5A539E8A348B" id="BPMNEdge_sid-AEAE5FF5-69DF-4C54-B639-5A539E8A348B">
<omgdi:waypoint x="400.0" y="295.0"></omgdi:waypoint>
<omgdi:waypoint x="569.0" y="295.0"></omgdi:waypoint>
<omgdi:waypoint x="569.0" y="144.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-08B0BFEC-473C-4E0E-960B-48CF442670F3" id="BPMNEdge_sid-08B0BFEC-473C-4E0E-960B-48CF442670F3">
<omgdi:waypoint x="165.0" y="130.0"></omgdi:waypoint>
<omgdi:waypoint x="300.0" y="130.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-3D34402A-FC77-4520-B40C-846BCA2C8727" id="BPMNEdge_sid-3D34402A-FC77-4520-B40C-846BCA2C8727">
<omgdi:waypoint x="352.38588167763027" y="186.79047103949463"></omgdi:waypoint>
<omgdi:waypoint x="350.8819488267068" y="255.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>
2.3 测试类
TimeBoundaryTest.java
import com.it.cloud.modules.activiti.service.IActReModelService;
import org.activiti.engine.HistoryService;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.TaskService;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* 定时边界事件
*/
@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)
public class TimeBoundaryTest {
@Autowired
private IActReModelService actReModelService;
@Autowired
private RuntimeService runtimeService;
@Autowired
private RepositoryService repositoryService;
@Autowired
private TaskService taskService;
@Autowired
private HistoryService historyService;
/**
* 部署流程定义
*/
@Test
public void deploy() {
Deployment deployment = repositoryService.createDeployment() // 创建部署
.addClasspathResource("diagrams/timerBoundary.bpmn20.xml") // 加载流程资源文件
.name("timerBoundary流程") // 流程名称
.deploy(); // 部署
System.out.println("流程部署ID:" + deployment.getId());
System.out.println("流程部署Name:" + deployment.getName());
}
/**
* 启动流程实例
*/
@Test
public void start() {
ProcessInstance pi = runtimeService.startProcessInstanceByKey("timerBoundary"); // 流程定义表的KEY字段值
System.out.println("流程实例ID:" + pi.getId());
System.out.println("流程定义ID:" + pi.getProcessDefinitionId());
//查询任务
List<Task> taskList = taskService.createTaskQuery() // 创建任务查询
.taskAssignee("test1") // 指定某个人
.list();
for (Task task : taskList) {
System.out.println("任务ID:" + task.getId());
System.out.println("任务名称:" + task.getName());
System.out.println("任务创建时间:" + task.getCreateTime());
System.out.println("任务委派人:" + task.getAssignee());
System.out.println("流程实例ID:" + task.getProcessInstanceId());
}
try {
Thread.sleep(1000 * 70);
} catch (InterruptedException e) {
e.printStackTrace();
}
// 查询任务
taskList = taskService.createTaskQuery() // 创建任务查询
.taskAssignee("test2") // 指定某个人
.list();
for (Task task : taskList) {
System.out.println("任务ID:" + task.getId());
System.out.println("任务名称:" + task.getName());
System.out.println("任务创建时间:" + task.getCreateTime());
System.out.println("任务委派人:" + task.getAssignee());
System.out.println("流程实例ID:" + task.getProcessInstanceId());
}
}
/**
* 查看任务
*/
@Test
public void queryTask() {
List<Task> taskList = taskService.createTaskQuery() // 创建任务查询
.taskAssignee("admin") // 指定某个人
.list();
for (Task task : taskList) {
System.out.println("任务ID:" + task.getId());
System.out.println("任务名称:" + task.getName());
System.out.println("任务创建时间:" + task.getCreateTime());
System.out.println("任务委派人:" + task.getAssignee());
System.out.println("流程实例ID:" + task.getProcessInstanceId());
}
}
/**
* 完成任务
*/
@Test
public void completeTask() {
taskService.complete("270011");
}
}
2.4 运行
运行deploy()
2.4.1 启动任务
运行start()
效果:
刚开始数据表中ACT_RU_TIMER_JOB会添加一条数据,duedate_显示下一次执行任务时间。
数据表ACT_RU_TASK中任务节点为初级工程师
隔一分钟过后ACT_RU_TIMER_JOB数据消失,数据表ACT_RU_TASK中任务节点为高级工程师
控制台如下,中间那条未测试数据,请忽略,只关注红框就好
源码地址
IT-CLOUD-ACTIVITI6
开源项目,持续更新中,喜欢请 Star~
项目推荐
IT-CLOUD :IT服务管理平台,集成基础服务,中间件服务,监控告警服务等。
开源项目,持续更新中,喜欢请 Star~