前言

　　工作流程是我们日常开发项目中常见的功能，本文记录springboot整合activiti7。

　　Activiti介绍

　　官网：https://www.activiti.org

　　数据库表

　　act_hi_*：'hi’表示 history，此前缀的表包含历史数据，如历史(结束)流程实例，变量，任务等等。

　　act_ge_*：'ge’表示 general，此前缀的表为通用数据，用于不同场景中。

　　act_evt_*：'evt’表示 event，此前缀的表为事件日志。

　　act_procdef_*：'procdef’表示 processdefine，此前缀的表为记录流程定义信息。

　　act_re_*：'re’表示 repository，此前缀的表包含了流程定义和流程静态资源(图片，规则等等)。

　　act_ru_*：'ru’表示 runtime，此前缀的表是记录运行时的数据，包含流程实例，任务，变量，异步任务等运行中的数据。Activiti只在流程实例执行过程中保存这些数据，在流程结束时就会删除这些记录。

表名    表注释

act_ge_bytearray    二进制数据表，存储通用的流程定义和流程资源。

act_ge_property    系统相关属性，属性数据表存储整个流程引擎级别的数据，初始化表结构时，会默认插入三条记录。

act_re_deployment    部署信息表

act_re_model    流程设计模型部署表

act_re_procdef    流程定义数据表

act_ru_deadletter_job    作业死亡信息表，作业失败超过重试次数

act_ru_event_subscr    运行时事件表

act_ru_execution    运行时流程执行实例表

act_ru_identitylink    运行时用户信息表

act_ru_integration    运行时积分表

act_ru_job    运行时作业信息表

act_ru_suspended_job    运行时作业暂停表

act_ru_task    运行时任务信息表

act_ru_timer_job    运行时定时器作业表

act_ru_variable    运行时变量信息表

act_hi_actinst    历史节点表

act_hi_attachment    历史附件表

act_hi_comment    历史意见表

act_hi_detail    历史详情表，提供历史变量的查询

act_hi_identitylink    历史流程用户信息表

act_hi_procinst    历史流程实例表

act_hi_taskinst    历史任务实例表

act_hi_varinst    历史变量表

act_evt_log    流程引擎的通用事件日志记录表

act_procdef_info    流程定义的动态变更信息

　　BPM节点介绍

　　根据BPMN2.0规范的分类划分为以下部分：
　　1.启动与结束事件(event)
　　2.顺序流(Sequence Flow)
　　3.任务(Task)
　　4.网关(Gateway)
　　5.子流程(Subprocess)
　　6.边界事件(Boundary Event)
　　7.中间事件(Intermediate Event)
　　8.监听器(Listener)

　　Event

　　StartEvent，开始事件。

　　EndEvent，结束事件。

　　Task

　　UserTask，用户任务，用户任务用来设置必须由人员完成的工作。

Assignee指定用户任务的处理人

Cadidate Users指定用户任务的候选人，多个用逗号隔开

Cadidate Groups指定多个候选组，多个用逗号隔开

Due Date设置任务的到期日，通常用变量代替而不是设定一个具体的日期

Priority设定任务的优先级，取值区间[0,100]

属性名称属性说明

　　ScriptTask，脚本任务，脚本任务是一个自动节点，当流程到达脚本任务。

　　ServiceTask，服务任务

　　Gateway

　　ParallelGateway，并行网关，顺序流没有条件解析，且分支执行不分先后。例如下面流程，需要科任老师批准、班主任批准，请假流程才能结束。

　　ExclusiveGateway，排他网关，条件解析为true的顺序流会被选中，流程往前走。例如下面流程，请假天数小于等于1天，科任老师老师批准，请假流程结束；请假天数大于1天，就需要班主任批准。

　　InclusiveGateway，包含网关，并行与排他的结合体，所有顺序流的条件都会被解析，结果为true的顺序会以并行方式继续执行。例如下面流程，请假天数小于等于1天，科任老师老师批准，请假流程结束；请假天数大于1天，班主任批准，请假流程结束；请假天数大于三天，就需要班主任批准、校长批准，请假流程才能结束。

　　开发前准备

　　Idea安装actiBPM插件，用于绘制流程图

　　画流程图

　　创建bpmn文件，画一个简单的请假流程

　　代码编写

　　项目结构

　　引入依赖包

<!-- activiti -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-spring-boot-starter</artifactId>
            <version>7.1.0.M5</version>
        </dependency>
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-image-generator</artifactId>
            <version>7.1.0.M5</version>
        </dependency>

        <!--添加MySQL驱动依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

        <!-- thymeleaf模板 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

　　springboot整合的activiti，默认自带security框架，为了方便测试，我们直接用官方提供的config类

　　传统项目分层：controller层、service层

　　为了扩展、丰富原生的流程图生成器，创建自定义ProcessDiagramGenerator与ProcessDiagramCanvas

　　三个简单页面

　　１、流程发起，填写业务表单，发起一个请假流程

　　２、任务待办，查询指定用户的流程任务列表，并完成任务

　　３、查看流程，查询指定用户发起的流程列表，并查看实时流程图

　　效果演示

　　自动建表

　　数据库无相关表，启动程序，就会自动创建相关的表，共25张

　　注：自动创建的表中，act_re_deployment少两个字段，部署流程时报错，补全即可（VERSION_、PROJECT_RELEASE_VERSION_）

　　流程部署　

　　单元测试，部署刚才的请假流程

import org.activiti.engine.*;
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;

@RunWith(SpringRunner.class)
@SpringBootTest
public class  SpringbootActiviti7ApplicationTests {

    @Autowired
    private RepositoryService repositoryService;


    /**
     * 流程部署
     */
    @Test
    public void test() {
        repositoryService.createDeployment()
                .addClasspathResource("bpm/askForLeaveBpm.bpmn")
                .name("请假流程")
                .key("ASK_FOR_LEAVE_ACT")
                .deploy();

        System.out.println("流程部署成功！");
    }
}

　　流程发起

　　http://localhost:10010/activiti/index
　　发起两个请假流程，一个1天、一个5天

　　查看流程

　　http://localhost:10010/activiti/getHistoricProcessInstanceByUserName?username=zhangsan

　　查看指定用户发起的流程

　　任务待办

　　http://localhost:10010/activiti/queryUserTaskByUserName?username=wangwu
　　查看任务待办，项目经理：lisi、部门经理：wangwu，并完当前成流程节点，流程会自动推进直至流程结束

　　流程结束

　　key1，请假小于3天，项目经理李四审批后流程直接结束
　　key2，请假大于3天，项目经理审批后，到部门经理审批，然后流程才结束

　　代码开源

　　代码已经开源、托管到我的GitHub、码云：

　　GitHub：https://github.com/huanzi-qch/springBoot

　　码云：https://gitee.com/huanzi-qch/springBoot

　　后记

　　简单的整合实例暂时先记录到这，后续有空再补充。

　　参考

　　https://www.cnblogs.com/xuweiweiwoaini/p/13660394.html

　　https://www.jianshu.com/nb/41785678

　　https://blog.csdn.net/zhouchenjun001/article/details/103629559

版权声明

作者：huanzi-qch

出处：https://www.cnblogs.com/huanzi-qch

若标题中有“转载”字样，则本文版权归原作者所有。若无转载字样，本文版权归作者所有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文链接，否则保留追究法律责任的权利.