醋醋百科网

Good Luck To You!

SpringBoot系列——Activiti7工作流引擎

 前言

  工作流程是我们日常开发项目中常见的功能,本文记录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文件,画一个简单的请假流程


  代码编写

  项目结构


  引入依赖包


        
            org.activiti
            activiti-spring-boot-starter
            7.1.0.M5
        
        
            org.activiti
            activiti-image-generator
            7.1.0.M5
        

        
        
            org.springframework.boot
            spring-boot-starter-jdbc
        
        
            mysql
            mysql-connector-java
        

        
        
            org.springframework.boot
            spring-boot-starter-thymeleaf
        

        
            org.springframework.boot
            spring-boot-starter-test
            test
        


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



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


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


  三个简单页面


  1、流程发起,填写业务表单,发起一个请假流程

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

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



  效果演示

  自动建表

  数据库无相关表,启动程序,就会自动创建相关的表,共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

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

控制面板
您好,欢迎到访网站!
  查看权限
网站分类
最新留言