事件等简介摘抄自官方文档
*后台服务基于Springboot2 + Activiti6,整合文章请参考:https://blog.csdn.net/yy756127197/article/details/101211510 不需要流程设计器就排除3,4步骤 *
1. 简介
1.1 错误事件定义
错误事件是由指定错误触发的。
2. 错误边界事件
2.1 简介
错误边界事件依附在某个流程活动中,用于不活流程中抛出的错误,一般用在嵌入子流程或者调用子流程。错误边界事件会接收错误信号,通过设置errorRef属性,如果没有使用该属性,错误边界事件将会捕获任何错误事件而不抛出的errrorCode。
2.2 流程设计
例如:一个服务节点抛出异常后交给用户节点处理。
服务任务设置
定义class, class中抛出errorCode,错误边界事件会接受该错误信号。
Class类
import org.activiti.engine.delegate.BpmnError;
import org.activiti.engine.delegate.DelegateExecution;
import org.activiti.engine.delegate.JavaDelegate;
import java.io.Serializable;
/**
* @author 司马缸砸缸了
* @description
* @date 2019/10/09 16:34
*/
public class ErrorBoundaryDelegate implements JavaDelegate, Serializable {
@Override
public void execute(DelegateExecution execution) {
String errorCode = "aaa";
System.out.println("抛出错误errorCode:"+ errorCode);
throw new BpmnError(errorCode);
}
}
错误边界事件设置
说明:
Error reference 设置成“aaa”代表该错误边界事件将会捕获errorCode为"aaa"的异常。
流程图
流程文件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="errorBoundary" name="errorBoundary" isExecutable="true">
<documentation>errorBoundary</documentation>
<startEvent id="startEvent1"></startEvent>
<serviceTask id="sid-71B91B18-9B46-4AA6-A404-E965C09DD289" name="服务任务" activiti:class="com.it.cloud.activiti.boundary.delegate.ErrorBoundaryDelegate"></serviceTask>
<sequenceFlow id="sid-73E51C89-F7FB-486C-BC75-977178D0E8C7" sourceRef="startEvent1" targetRef="sid-71B91B18-9B46-4AA6-A404-E965C09DD289"></sequenceFlow>
<endEvent id="sid-AFE32B9E-81CC-4EC5-ABAA-B99784EBB95A"></endEvent>
<sequenceFlow id="sid-F2A021B5-A2A6-457B-B3F9-6AF1D5F479BA" sourceRef="sid-71B91B18-9B46-4AA6-A404-E965C09DD289" targetRef="sid-AFE32B9E-81CC-4EC5-ABAA-B99784EBB95A"></sequenceFlow>
<userTask id="sid-BE90C8BB-C29C-4D0A-85A0-C399E2D59EA7" name="ERROR TASK" activiti:assignee="errorUser">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://activiti.com/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-D28EA4DA-1C42-4A14-9EAA-ED8D85784D40" sourceRef="sid-E35B06FD-32DB-4A96-BF00-D881FF1BA10D" targetRef="sid-BE90C8BB-C29C-4D0A-85A0-C399E2D59EA7"></sequenceFlow>
<boundaryEvent id="sid-E35B06FD-32DB-4A96-BF00-D881FF1BA10D" attachedToRef="sid-71B91B18-9B46-4AA6-A404-E965C09DD289">
<errorEventDefinition errorRef="aaa"></errorEventDefinition>
</boundaryEvent>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_errorBoundary">
<bpmndi:BPMNPlane bpmnElement="errorBoundary" id="BPMNPlane_errorBoundary">
<bpmndi:BPMNShape bpmnElement="startEvent1" id="BPMNShape_startEvent1">
<omgdc:Bounds height="30.0" width="30.0" x="195.0" y="92.5"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-71B91B18-9B46-4AA6-A404-E965C09DD289" id="BPMNShape_sid-71B91B18-9B46-4AA6-A404-E965C09DD289">
<omgdc:Bounds height="80.0" width="100.0" x="350.0" y="67.5"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-AFE32B9E-81CC-4EC5-ABAA-B99784EBB95A" id="BPMNShape_sid-AFE32B9E-81CC-4EC5-ABAA-B99784EBB95A">
<omgdc:Bounds height="28.0" width="28.0" x="555.0" y="93.5"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-BE90C8BB-C29C-4D0A-85A0-C399E2D59EA7" id="BPMNShape_sid-BE90C8BB-C29C-4D0A-85A0-C399E2D59EA7">
<omgdc:Bounds height="80.0" width="100.0" x="350.0" y="225.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-E35B06FD-32DB-4A96-BF00-D881FF1BA10D" id="BPMNShape_sid-E35B06FD-32DB-4A96-BF00-D881FF1BA10D">
<omgdc:Bounds height="30.0" width="30.0" x="383.84977184273157" y="133.33309958302863"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="sid-73E51C89-F7FB-486C-BC75-977178D0E8C7" id="BPMNEdge_sid-73E51C89-F7FB-486C-BC75-977178D0E8C7">
<omgdi:waypoint x="225.0" y="107.5"></omgdi:waypoint>
<omgdi:waypoint x="350.0" y="107.5"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-D28EA4DA-1C42-4A14-9EAA-ED8D85784D40" id="BPMNEdge_sid-D28EA4DA-1C42-4A14-9EAA-ED8D85784D40">
<omgdi:waypoint x="398.99765083694325" y="163.33237062541835"></omgdi:waypoint>
<omgdi:waypoint x="399.6056368505009" y="225.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-F2A021B5-A2A6-457B-B3F9-6AF1D5F479BA" id="BPMNEdge_sid-F2A021B5-A2A6-457B-B3F9-6AF1D5F479BA">
<omgdi:waypoint x="450.0" y="107.5"></omgdi:waypoint>
<omgdi:waypoint x="555.0" y="107.5"></omgdi:waypoint>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>
2.3 测试类
ErrorBoundaryTest.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.Execution;
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.List;
/**
* 错误边界事件
*/
@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)
public class ErrorBoundaryTest {
@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/errorBoundary.bpmn20.xml") // 加载流程资源文件
.name("errorBoundary流程") // 流程名称
.deploy(); // 部署
System.out.println("流程部署ID:" + deployment.getId());
System.out.println("流程部署Name:" + deployment.getName());
}
/**
* 启动流程实例
*/
@Test
public void start() throws InterruptedException {
ProcessInstance pi = runtimeService.startProcessInstanceByKey("errorBoundary"); // 流程定义表的KEY字段值
System.out.println("流程实例ID:" + pi.getId());
System.out.println("流程定义ID:" + pi.getProcessDefinitionId());
// 睡一会
Thread.sleep(1000 * 5);
System.out.println("--------------------------------------------");
// 查询任务
List<Task> taskList2 = taskService.createTaskQuery() // 创建任务查询
.taskAssignee("errorUser") // 指定某个人
.list();
for (Task task : taskList2) {
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("errorUser") // 指定某个人
.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("275005");
}
}
2.4 运行
运行deploy()
2.4.1 启动任务
运行start()
效果:
服务任务抛出"aaa"的errorCode,错误边界事件捕获到之后到达用户节点
控制台如下
源码地址
IT-CLOUD-ACTIVITI6
开源项目,持续更新中,喜欢请 Star~
项目推荐
IT-CLOUD :IT服务管理平台,集成基础服务,中间件服务,监控告警服务等。
开源项目,持续更新中,喜欢请 Star~