文章目录
Activiti项目是一项新的基于Apache许可的开源BPM平台,从基础开始构建,旨在提供支持新的BPMN 2.0标准,包括支持对象管理组(OMG),面对新技术的机遇,诸如互操作性和云架构,提供技术实现。
本系列是入门级别,主要讲述Activiti的各个功能使用方法
*后台服务基于Springboot2 + Activiti6,整合文章请参考:https://blog.csdn.net/yy756127197/article/details/101211510 不需要流程设计器就排除3,4步骤 *
1. 简介
1.1 7大接口
- RepositoryService:提供管理流程部署和流程定义API。
- RuntimeService:提供运行时流程实例进行管理与控制API。
- TaskService:提供流程任务管理API。
- IdentityService:提供对流程用户数据进行管理的API,包括用户组、用户及用户–组关系。
- ManagementService:提供对流程引擎进行管理和维护的服务。
- HistoryService:提供流程的历史数据进行操作API。
- FormService:提供表单服务。
1.2 28张表
表 | 备注 |
---|---|
act_ge_ 通用数据表 | ge是general的缩写 |
act_hi_ 历史数据表 | hi是history的缩写,对应HistoryService接口 |
act_id_ 身份数据表 | id是identity的缩写,对应IdentityService接口 |
act_re_ 流程存储表 | re是repository的缩写,对应RepositoryService接口,存储流程部署和流程定义等静态数据 |
act_ru_ 运行时数据表 | ru是runtime的缩写,对应RuntimeService接口和TaskService接口,存储流程实例和用户任务等动态数据 |
表结构:
1:资源库流程规则表
1) act_re_deployment 部署信息表
2) act_re_model 流程设计模型部署表
3) act_re_procdef 流程定义数据表
2:运行时数据表
1) act_ru_execution 运行时流程执行实例表
2) act_ru_identitylink 运行时流程人员表,主要存储任务节点与参与者的相关信息
3) act_ru_task 运行时任务节点表
4) act_ru_variable 运行时流程变量数据表
3:工作数据表
1) act_ru_job 一般工作表
2) act_ru_deadletter_job 无法执行工作表,用于存放无法执行的工作
3) act_ru_suspended_job 中断工作表,中断工作产生后,会将工作保存到该表
4) act_ru_timer_job 定时器工作表
4:事件描述表
1) act_ru_event_subscr 事件描述表
5:历史数据表
1) act_hi_actinst 历史节点表
2) act_hi_attachment 历史附件表
3) act_hi_comment 历史意见表
4) act_hi_identitylink 历史流程人员表
5) act_hi_detail 历史详情表,提供历史变量的查询
6) act_hi_procinst 历史流程实例表
7) act_hi_taskinst 历史任务实例表
8) act_hi_varinst 历史变量表
6:组织机构表
1) act_id_group 用户组信息表
2) act_id_info 用户扩展信息表
3) act_id_membership 用户与用户组对应信息表
4) act_id_user 用户信息表
这四张表很常见,基本的组织机构管理,关于用户认证方面建议还是自己开发一套,组件自带的功能太简单,使用中有很多需求难以满足
7:通用数据表
1) act_ge_bytearray 二进制数据表
2) act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时,会默认插入三条记录
8:其他数据表
1) act_evt_log 存储事件处理日志,方便管理员跟踪处理
2) act_procdef_info 流程定义信息(新增)
2. 第一个实例Hello world
2.1 流程设计
流程图
流程文件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="helloworld" name="helloworld" isExecutable="true">
<startEvent id="startEvent1"></startEvent>
<userTask id="userTask1" name="用户节点" activiti:assignee="admin">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://activiti.com/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-EC85E74C-7AB4-42EA-BFED-1FD829AF299D" sourceRef="startEvent1" targetRef="userTask1"></sequenceFlow>
<endEvent id="sid-A8829272-31FB-48E0-81CE-CDB2D74192C1"></endEvent>
<sequenceFlow id="sid-128AE139-627A-4280-9C20-690E05717C8E" sourceRef="userTask1" targetRef="sid-A8829272-31FB-48E0-81CE-CDB2D74192C1"></sequenceFlow>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_helloworld">
<bpmndi:BPMNPlane bpmnElement="helloworld" id="BPMNPlane_helloworld">
<bpmndi:BPMNShape bpmnElement="startEvent1" id="BPMNShape_startEvent1">
<omgdc:Bounds height="30.0" width="30.0" x="375.0" y="30.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="userTask1" id="BPMNShape_userTask1">
<omgdc:Bounds height="80.0" width="100.0" x="340.0" y="135.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sid-A8829272-31FB-48E0-81CE-CDB2D74192C1" id="BPMNShape_sid-A8829272-31FB-48E0-81CE-CDB2D74192C1">
<omgdc:Bounds height="28.0" width="28.0" x="376.0" y="300.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="sid-128AE139-627A-4280-9C20-690E05717C8E" id="BPMNEdge_sid-128AE139-627A-4280-9C20-690E05717C8E">
<omgdi:waypoint x="390.0" y="215.0"></omgdi:waypoint>
<omgdi:waypoint x="390.0" y="300.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sid-EC85E74C-7AB4-42EA-BFED-1FD829AF299D" id="BPMNEdge_sid-EC85E74C-7AB4-42EA-BFED-1FD829AF299D">
<omgdi:waypoint x="390.0" y="60.0"></omgdi:waypoint>
<omgdi:waypoint x="390.0" y="135.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>
2.2 测试类
HelloWorldProcessTest.java
import com.it.cloud.modules.activiti.service.IActReModelService;
import io.github.swagger2markup.GroupBy;
import io.github.swagger2markup.Language;
import io.github.swagger2markup.Swagger2MarkupConfig;
import io.github.swagger2markup.Swagger2MarkupConverter;
import io.github.swagger2markup.builder.Swagger2MarkupConfigBuilder;
import io.github.swagger2markup.markup.builder.MarkupLanguage;
import org.activiti.engine.*;
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.net.URL;
import java.nio.file.Paths;
import java.util.List;
@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)
public class HelloWorldProcess {
@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/helloworld.bpmn20.xml") // 加载流程资源文件
.name("helloworld流程") // 流程名称
.deploy(); // 部署
System.out.println("流程部署ID:" + deployment.getId());
System.out.println("流程部署Name:" + deployment.getName());
}
/**
* 启动流程实例
*/
@Test
public void start() {
ProcessInstance pi = runtimeService.startProcessInstanceByKey("helloworld"); // 流程定义表的KEY字段值
System.out.println("流程实例ID:" + pi.getId());
System.out.println("流程定义ID:" + pi.getProcessDefinitionId());
}
/**
* 查看任务
*/
@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("20005");
}
}
2.3 运行
2.3.1 部署
运行deploy()
效果:
2.3.2 启动流程
运行start()
效果:
2.3.3 查询任务
运行queryTask()
效果:
红色框中的数据是查询出来的,上面的是其他测试数据,请忽略
2.3.4 完成任务
运行completeTask()
效果:
观察act_ru_execution, act_ru_task表数据已经清空,act_hi_taskinst等历史表数据添加
参考
1.https://blog.csdn.net/babylovewei/article/details/85166182
2.http://www.java1234.com/ activiti系列视频
源码地址
IT-CLOUD-ACTIVITI6
开源项目,持续更新中,喜欢请 Star~
项目推荐
IT-CLOUD :IT服务管理平台,集成基础服务,中间件服务,监控告警服务等。
开源项目,持续更新中,喜欢请 Star~