SpringBoot + Flowable的基础使用

Flowable是一个流行的轻量级的采用Java开发的业务流程引擎。通过Flowable流程引擎,我们可以部署BPMN2.0的流程定义(一般为XML文件),通过流程定义创建流程实例,查询和访问流程相关的实例与数据,等等。

Flowable可以灵活地添加到我们的服务、应用、架构中,可以通过引入Flowable jar包,或者直接使用Flowable的Rest API来进行业务流程引擎的操作。

Flowable是基于Activity5.0的一个分支开发的,因此内部的很多概念都相似。

  1. 我用的IDEA创建SpringBoot项目,我的项目版本是:2.2.0.RELEASE,这一步我就不贴出来了,

  2. 然后在pom文件中引入jar包:
    SpringBoot + Flowable的基础使用_第1张图片

  3. 添加一个数据源,我这里添加的mysql,Flowable需要持久化数据。这个是我的配置文件 application.yml:
    SpringBoot + Flowable的基础使用_第2张图片

  4. 启动项目,可以看到数据库中创建了很多flowable默认的表,其中有flowable历史流程相关的(eg: ACT_HI开头的…),运行中相关的(eg: ACT_RU开头的…),用户用户组信息相关(eg: ACT_ID开头的…):
    SpringBoot + Flowable的基础使用_第3张图片

  5. 将springboot与flowable整合完成之后,就可以进行工作流的开发了,

flowable建议采用业界标准BPMN2.0的XML来描述需要定义的工作流。所以我们需要在项目中创建一个流程定义,下面这个是我创建的一个xml定义, 截图不全,源码中有:
SpringBoot + Flowable的基础使用_第4张图片

看到这里是不是觉得这个文件很复杂,至少对于之前没有用过工作流的我来说看着很复杂的,看不懂。然后在晚上一系列搜索,有的说可以用eclipse的自带插件生成,我用的又是IDEA,

所以找到一篇文章:flowable+tomcat部署flowable项目,在线画流程图。此文版本较低,仅供参考,原文链接:https://www.wandouip.com/t5i212543/

在我们下载安装好tomcat之后,可以通过:https://github.com/flowable/flowable-engine/releases/download/flowable-6.7.0/flowable-6.7.0.zip 下载flowable的zip文件

下载下来解压之后,我们把flowable-6.7.0/wars 下的所有war包复制到tomcat/webapps下面:
SpringBoot + Flowable的基础使用_第5张图片

复制过去之后,启动tomcat,上面红线圈起来的文件夹是tomcat启动之后自动解压生成的:
SpringBoot + Flowable的基础使用_第6张图片

启动过程可能有点慢,要全部启动flowable的这几个服务,看到下面这个就启动完成了:
SpringBoot + Flowable的基础使用_第7张图片

启动成功之后,可以登陆创建流程:http://localhost:8080/flowable-ui/
密码是:test
SpringBoot + Flowable的基础使用_第8张图片

可以开始创建:
SpringBoot + Flowable的基础使用_第9张图片

这个就是我创建的一个流程:
SpringBoot + Flowable的基础使用_第10张图片

审批流程:1.创建流程->ApproveRequest->通过审批->执行SuccessService业务->流程到firstApproveTask节点…结束。 ApproveRequest->审批不通过->执行失败业务->结束

创建完成之后:可以导出BPMN2:
SpringBoot + Flowable的基础使用_第11张图片

可以打开下载的文件,自动转成xml格式,是不是很方便,不用自己全部写:
SpringBoot + Flowable的基础使用_第12张图片

然后再把这个下载文件拷贝项目中: resources/processes/ 目录下:
SpringBoot + Flowable的基础使用_第13张图片

然后可以在Controller文件中创建接口测试这个工作流:
SpringBoot + Flowable的基础使用_第14张图片

这些是我引入的flowable相关的,接下来创建流程:
SpringBoot + Flowable的基础使用_第15张图片

userId: 创建人id, days:请假天数 , reason:请假原因。

方法里边把这些参数传入map中的key就是流程变量,后面的方法可以取出来使用。holidayRequest: 就是xml文件中标签的id,就是之前创建的流程定义。

接下来可以在postman中测试一下:
SpringBoot + Flowable的基础使用_第16张图片SpringBoot + Flowable的基础使用_第17张图片

可以看到postman测试成功,数据库表中有了相应数据。

然后可以创建显示流程图的接口:
SpringBoot + Flowable的基础使用_第18张图片

在postman中传入流程id测试一下:
SpringBoot + Flowable的基础使用_第19张图片

大家可以看到查询出了之前在flowable中创建的流程定义,并且可以看到当前流程在Approverequest这个节点(红线圈起来的),因为之前只是用户提交了审批流程。所以现在到了第二个节点。

接着创建审批通过接口:
SpringBoot + Flowable的基础使用_第20张图片SpringBoot + Flowable的基础使用_第21张图片

可以看到接口中的approved,就是流程定义中${approved}变量,画流程图的时候可以定义。如果传入的为true则执行上面的流程逻辑,false则执行下面的。

接着我们再测试一下,可以看到审批通过:
SpringBoot + Flowable的基础使用_第22张图片

再看一下流程图:
SpringBoot + Flowable的基础使用_第23张图片

可以看到同一个流程实例,流程又到了下一个节点。

我们可以查询一个指定用户/用户组的任务列表:
SpringBoot + Flowable的基础使用_第24张图片

xml中的flowable:candidateGroups = “first” 说明这个任务只有用户组为first的用户才可以执行、查询。

上面可以看到流程已经到了firstApprovedTask节点,说明只有first用户组才可以查询或执行。我们再测试一下:
SpringBoot + Flowable的基础使用_第25张图片SpringBoot + Flowable的基础使用_第26张图片

大家可以看到当传入 managers的时候,是查不出来任务数据的,传入first的时候就可以查询出来了。说明是正确的。

Controller中还有一些其他方法,我就没有全部贴出来:

包括:

  1. 查询历史流程记录
  2. 驳回流程实例
  3. 终止流程实例
  4. 挂起流程实例
  5. 恢复(唤醒)被挂起的流程实例
  6. 判断传入流程实例在运行中是否存在
  7. 判断流程实例在历史记录中是否存在

其他的功能还在探索,以上就是我学习flowable这两天的一些收获。如果某些地方不对的,还请大家指出来,谢谢。

记录学习过程,原文地址:https://www.jianshu.com/p/e8f4e9a7bd8a

本文源码地址:https://github.com/ImPYJ/FlowableDemo

你可能感兴趣的:(flowable,tomcat,mysql,spring,boot,java)