【弄nèng - Activiti6】Activiti6入门篇（一）—— HelloWorld

Activiti项目是一项新的基于Apache许可的开源BPM平台，从基础开始构建，旨在提供支持新的BPMN 2.0标准，包括支持对象管理组（OMG），面对新技术的机遇，诸如互操作性和云架构，提供技术实现。
本系列是入门级别，主要讲述Activiti的各个功能使用方法

*后台服务基于Springboot2 + Activiti6，整合文章请参考：https://blog.csdn.net/yy756127197/article/details/101211510 不需要流程设计器就排除3,4步骤 *

1. 简介

1.1 7大接口

1. RepositoryService：提供管理流程部署和流程定义API。
2. RuntimeService：提供运行时流程实例进行管理与控制API。
3. TaskService：提供流程任务管理API。
4. IdentityService：提供对流程用户数据进行管理的API，包括用户组、用户及用户–组关系。
5. ManagementService：提供对流程引擎进行管理和维护的服务。
6. HistoryService：提供流程的历史数据进行操作API。
7. 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~