Springboot整合Flowable流程引擎

文章详细介绍了Flowable的主要表结构,包括通用数据表、运行时数据表、历史数据表、身份数据表和流程定义数据表。接着,阐述了如何在SpringBoot中整合Flowable,包括流程定义、引入依赖、启动服务及解决启动时可能出现的问题,如数据库驱动版本和索引长度限制。同时,文章还涉及了BPMN插件的下载、流程的部署、启动和完成流程的操作。
摘要由CSDN通过智能技术生成

前言

Flowable是一个开源的工作流引擎,它基于Activiti引擎进行发展,Flowable主要用于为业务流程管理(BPM)和工作流的设计、操作、监控提供支持。

1. Flowable的主要表结构

1.1 通用数据表(通用表)

这类表在Flowable中主要提供存储通用类型数据的功能,如流程名称,创建时间等。如下是通用表的主要成员:

  • act_ge_bytearray:存储二进制数据,如流程定义文件,流程图等。
  • act_ge_property:存储系统全局属性,如数据库版本信息等。

1.2运行时数据表(runtime表)

这类表主要用于在流程运行过程中,存储实时的流程数据。如下是运行时数据表的主要成员:

  • act_ru_event_subscr:存储运行时事件订阅数据,如boundary事件等。
  • act_ru_execution:存储运行时流程实例,包括当前状态,子流程引用等。
  • act_ru_identitylink:存储运行时任务的参与者(用户与组)的关联关系。
  • act_ru_job:存储工作任务的相关数据,如执行时间,重试次数等。
  • act_ru_task:存储运行时任务数据,如所属流程实例,任务名称等。
  • act_ru_variable:存储运行时的流程变量数据。

1.3.历史数据表(history表)

这类表主要用于在流程完成后,存储历史的流程数据,如流程实例,任务,变量等。如下是历史数据表的主要成员:

  • act_hi_attachment:存储附件相关历史数据。
  • act_hi_comment:存储评论相关历史数据。
  • act_hi_detail:存储流程变量修改相关历史数据。
  • act_hi_identitylink:存储任务参与者相关历史数据。
  • act_hi_procinst:存储流程实例相关历史数据。
  • act_hi_actinst:存储活动节点相关历史数据。
  • act_hi_taskinst:存储任务实例相关历史数据。
  • act_hi_varinst:存储流程变量相关历史数据。

1.4. 身份数据表(identity表)

这类表主要用于存储组织机构和用户权限相关的数据。如下是身份数据表的主要成员:

  • act_id_group:存储用户组相关数据。
  • act_id_membership:存储用户与用户组的关联关系。
  • act_id_user:存储用户相关数据。

1.5. 流程定义数据表(repository表)

这类表主要用于存储流程定义相关的数据。如下是流程定义数据表的主要成员:

  • act_re_deployment:存储流程部署相关数据。
  • act_re_model:存储流程设计模型相关数据。
  • act_re_procdef:存储流程定义相关数据。

2.springboot整合flowable

2.1 流程定义

  • . 流程定义(Process Definition):流程定义是包含所有流程与审批步骤(任务节点、网关等)的XML文件,通常使用BPMN(Business Process Model and Notation) 2.0语言编写。这些文件在部署到Flowable引擎时会存储到数据库中,以便在运行时创建实例。

  • 数据库表:Flowable使用关系型数据库来存储审批流相关的信息。其中的相关表格如下:

    • ACT_RE_PROCDEF: 存储流程定义信息
    • ACT_RE_DEPLOYMENT: 存储部署信息
    • ACT_RU_TASK: 存储运行时任务信息
    • ACT_RU_EXECUTION: 存储运行时流程实例
    • ACT_HI_PROCINST: 存储历史流程实例
    • ACT_HI_ACTINST: 存储历史活动实例
    • ACT_HI_TASKINST: 存储历史任务实例
    • ACT_HI_DETAIL: 存储历史明细数据
    • ACT_HI_COMMENT: 存储审批评论数据

2.2 引入依赖


  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <flowable.version>6.7.2</flowable.version>
  </properties>
  <dependency>
     <groupId>org.flowable</groupId>
     <artifactId>flowable-spring-boot-starter</artifactId>
     <version>${flowable.version}</version>
   </dependency>
 <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
     <!--flowable引擎自动配置-->
    <dependency>
      <groupId>org.flowable</groupId>
      <artifactId>flowable-spring-boot-starter</artifactId>
      <version>${flowable.version}</version>
    </dependency>
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.22</version>
    </dependency>

2.3 启动类

/**
 * 启动类
 *
 */
@SpringBootApplication
public class FlowableApplication
{
    public static void main( String[] args )
    {
        System.out.println("流程系统启动.................");
        SpringApplication.run(FlowableApplication.class,args);
        System.out.println("流程系统启动成功.................");
    }
}

2.4 启动服务

启动服务会在数据库自动创建flowable的表,可能会出现下边的错误。

2.4.1 启动错误,数据库驱动版本问题

nested exception is org.flowable.common.engine.api.FlowableException: Could not update Flowable database schema: unknown version from database: ‘6.8.0.0’
解决方法:
修改mysql驱动的版本为8.0.22

2.4.2 启动报错

Caused by: java.sql.SQLSyntaxErrorException: Specified key was too long; max key length is 767 bytes atcom.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:120) ~[mysql-connector-java-8.0.22.jar:8.0.22] at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97) ~[mysql-connector-java-8.0.22.jar:8.0.22]

项目mysql的版本5.6.51
导致上面报错的原因是由于InnoDB表的索引长度限制,在MySQL5.6版本后引入了参数innodb_large_prefix可以解决这个问题。该参数控制是否允许单列的索引长度超过767字节,有ON和OFF两个取值:
ON :Innodb表的行记录格式是Dynamic或Compressed的前提下,单列索引长度上限扩展到3072个字节
OFF:Innodb表的单例索引长度最多为767个字节,索引长度超出后,主键索引会创建失败,辅助索引会被截断成为前缀索引。
进行如下设置,重启mysql:

set global innodb_large_prefix = ON;
SET GLOBAL innodb_file_format=Barracuda;
SET GLOBAL innodb_file_per_table=ON;

2.4 下载BPMN插件

Visualizer
新建流程
BPMN

提交代码审批流程

文件的后缀名字 demo.bpmn20.xml

demo.bpmn20.xml

<?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:flowable="http://flowable.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.flowable.org/processdef">
  <process id="DemoProcess" name="DemoProcess">
    <startEvent id="start"/>
    <sequenceFlow id="flow1" sourceRef="start" targetRef="userTask"/>
    <userTask id="userTask" name="User Task" flowable:assignee="${creator}"/>
    <sequenceFlow id="flow2" sourceRef="userTask" targetRef="end"/>
    <endEvent id="end"/>
  </process>
</definitions>

2.5 部署流程

/**
 * 流程部署
 */
@Component
public class ProcessDeployer {
    @Autowired
    private RepositoryService repositoryService;

    @PostConstruct
    public void init() {
        repositoryService.createDeployment()
                .addClasspathResource("demo.bpmn20.xml")
                .deploy();
    }
}

启动完成之后数据库表存储流程定义:=>ACT_RE_PROCDEF
在这里插入图片描述
存储部署表
在这里插入图片描述

2.6 启动流程

    //查询指定流程所有启动的实例列表
    @Autowired
    private RuntimeService runtimeService;
  /**
     * 启动
     * @param creator
     */
    public void startProcess(String creator) {
        Map<String, Object> variables = new HashMap<>();
        variables.put("creator", creator);
        runtimeService.startProcessInstanceByKey("demoProcess", variables);
    }

2.7 完成流程

根据用户获取用户任务以及审批流

    @Autowired
    TaskService taskService;

    //获取用户ID获取的任务列表
    public List<Task> getTasksAssignedToUser(String userId) {

        TaskQuery taskQuery = taskService.createTaskQuery().taskAssignee(userId);
        return taskQuery.list();
    }
    //用户处理流程列表
    public void completeTask(String taskId, boolean approved) {
        Task task = taskService.createTaskQuery().taskId(taskId).singleResult();
        if (task != null) {
            Map<String, Object> variables = new HashMap<>();
            variables.put("approved", approved);
            taskService.complete(taskId, variables);
        }
    }
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小刘同学要加油呀

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值