SpringBoot整合Flowable【02】- 整合の初体验

一、版本选择

在我们正式建立项目前,我们先去flowable的github主页了解一下版本信息,flowable版本上大的区别主要以7.0.X版本作为界线,通过官方的版本说明我们知道7.0版本主要对JDK17和SpringBoot3做了支持,所以各位读者在选择版本的时候要根据自己项目目前Spring和JDK的版本进行选择,如果是非SpringBoot3.X的版本就使用Flowable7.0.X以下的版本就好。

二、创建项目

1.建立工程

平平无奇地创建一个项目,我的本机JDK版本为17,这里也就不做调整了。


由于SpringBoot2.X版本已经不再维护了,所以在创建时只能选择SpringBoot3.X版本,但是没关系,我们可以创建成功后在pom文件里修改一下。这里演示demo,我还是选择老派的版本咯。


通过查看github,可以看到 flowable 6.X最新的稳定版本是6.8.1,我也就使用这个版本了。所以,这里也想告诉初学者的一个点就是一定要学会去看文档,毕竟教程是具有滞后性的。通过官方的文档说明,我们springboot版本就使用2.7.18吧。

最终,我们的环境是JDK17、Springboot2.7.18、flowable 6.8.1,如果flowable 7.0.X以下的小伙伴使用JDK8也可以,我这只是懒得换环境。

2.导入依赖

这里主要就是Flowable的核心依赖,其他都是通用依赖。

xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.18</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.pitayafruit</groupId>
    <artifactId>FlowableDemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>FlowableDemo</name>
    <description>FlowableDemo</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <!-- spring-web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

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

        <!-- flowable -->
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-spring-boot-starter</artifactId>
            <version>6.8.1</version>
        </dependency>

        <!-- mysql -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.33</version>
        </dependency>

        <!-- 连接池 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.2.21</version>
        </dependency>

        <!-- 单元测试 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>

        <!-- 日志 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>2.0.12</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>2.0.12</version>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

3.建立数据库

Flowable需要数据库来存储数据,所以我们需要为它建立一个数据库,表结构则会由引擎为我们自动生成。

4.创建配置文件

配置没什么好说的,大家根据自己的情况进行配置就好。

yml 复制代码
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/flowable-demo?characterEncoding=UTF-8&serverTimezone=UTC
    username: root
    password: 123456

5.启动项目测试

项目成功启动时,我们可以看到控制台闪过很多提示信息,那是第一次启动项目,Flowable在为我们创建表。


项目启动成功后,可以在数据库中看到79张表,表示我们初步的整合已经成功了。另外,在实际业务中有条件的话,建议将工作流单独部署一个服务和数据库,一下子多了这么多的表在原有的数据库里,对我们管理还是有影响的。

三、表结构

为了更好地理解 Flowable 的实现原理和细节,有必要先理清楚相关表结构及其作用,接下来,我来帮各位读者梳理一下生成的这79张表。

1.表结构分类

Flowable在初始化时会创建五类表结构,具体如下:

  • ACT_RE:'RE'表示repository。这个前缀的表包含了流程定义和流程静态资源(图片,规则等等)。
  • ACT_RU:'RU'表示runtime。这些运行时的表,包含流程实例,任务,变量,异步任务等运行中的数据。Flowable只在流程实例执行过程中保存这些数据,在流程结束时就会删除这些记录。这样运行时表可以一直很小速度很快。
  • ACT_HI:'HI'表示history。这些表包含历史数据,比如历史流程实例,变量,任务等。
  • ACT_GE:'GE'表示general。存储Flowable在各种不同场景下需要的通用数据。
  • ACT_ID:'ID'表示identity (组织机构)。这些表包含标识的信息,如用户,用户组等。

其中ACT_ID类型的表应该在实际业务中是用不上的,因为实际业务都有自己的一套用户表结构,Flowable 里的这套应该是用不上的。

2.常用表的作用

第一次学习的同学可能乍一看这79张表会感到头疼,光是理清楚每张表和字段的作用就要花很长时间。但实际业务中,就像前文中说的,有些表我们从来就不会用,比如引擎自带的用户相关的表,在我们实际业务中,有我们自己的用户组关系和字段,所以在下面的表格中也不做罗列。

表名 解释
ACT_GE_BYTEARRAY 存储通用的流程定义和流程资源,即每个流程的部署记录。
ACT_GE_PROPERTY 存储系统相关属性,主要是Flowable 自身的一些变量。
ACT_HI_ACTINST 存储历史的活动信息,记录流程流转过的所有节点。
ACT_HI_ATTACHMENT 存储历史的流程的附件表。
ACT_HI_COMMENT 存储历史的流程说明性信息。
ACT_HI_DETAIL 存储历史的流程运行的细节信息,比如流程中产生的变量详细,包括控制流程流转的变量,业务表单中填写的流程需要用到的变量等。
ACT_HI_ENTITYLINK 存储历史参与的人员。
ACT_HI_IDENTITYLINK 存储任务参与者数据,主要存储历史节点参与者的信息,可能是 Group 也可能是 User。
ACT_HI_PROCINST 存储历史的流程实例,保存每一个历史流程,创建时就生成,一条流程实例对应一个记录。
ACT_HI_TASKINST 存储历史的任务实例,记录每一个历史节点,一个 Task 对应一个记录。
ACT_HI_TSK_LOG 存储历史的任务操作日志,每一次执行可能会带上数据,存在这里。
ACT_HI_VARINST 存储历史的流程运行中的变量信息。
ACT_RE_DEPLOYMENT 存储流程部署记录,每次服务重启会部署一次,这里会新增一条记录。
ACT_RE_MODEL 存储模型信息,创建模型时,额外定义的一些模型相关信息,存在这张表,默认不保存。
ACT_RE_PROCDEF 存储已部署的流程定义,记录流程的变更,流程每变更一次存一条记录,version_字段加1。
ACT_RU_EVENT_SUBSCR 存储运行时事件,当流程定义使用事件(信号/消息/等或启动/中间/边界)时,引擎将对该表的引用存储在该表中。
ACT_RU_EXECUTION 存储运行时流程执行实例和指向流程实例当前状态的指针。
ACT_RU_IDENTITYLINK 存储运行时用户关系信息,即任务节点与参与者的相关信息。
ACT_RU_JOB 存储运行时作业。
ACT_RU_TASK 存储运行时任务。
ACT_RU_VARIABLE 存储运行时变量,是与实例相关的变量。

即使仅仅罗列出这些表,初学者可能依然会觉得很难"记",但就像我们初学编程时一样,其实根本不需要特意记一些API,在用的过程中慢慢就熟悉了,在下一篇文章里,将带领大家正式开始编码,通过跑完一个简易的流程,让各位读者可以对相关API和表结构有一个初步的认识。😃

相关推荐
齐 飞22 分钟前
MongoDB笔记01-概念与安装
前端·数据库·笔记·后端·mongodb
九圣残炎31 分钟前
【从零开始的LeetCode-算法】1456. 定长子串中元音的最大数目
java·算法·leetcode
wclass-zhengge33 分钟前
Netty篇(入门编程)
java·linux·服务器
LunarCod39 分钟前
WorkFlow源码剖析——Communicator之TCPServer(中)
后端·workflow·c/c++·网络框架·源码剖析·高性能高并发
Re.不晚1 小时前
Java入门15——抽象类
java·开发语言·学习·算法·intellij-idea
雷神乐乐1 小时前
Maven学习——创建Maven的Java和Web工程,并运行在Tomcat上
java·maven
码农派大星。1 小时前
Spring Boot 配置文件
java·spring boot·后端
顾北川_野1 小时前
Android 手机设备的OEM-unlock解锁 和 adb push文件
android·java
江深竹静,一苇以航1 小时前
springboot3项目整合Mybatis-plus启动项目报错:Invalid bean definition with name ‘xxxMapper‘
java·spring boot
confiself2 小时前
大模型系列——LLAMA-O1 复刻代码解读
java·开发语言