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包：
   

3. 添加一个数据源，我这里添加的mysql，Flowable需要持久化数据。这个是我的配置文件 application.yml：
   

4. 启动项目，可以看到数据库中创建了很多flowable默认的表，其中有flowable历史流程相关的(eg: ACT_HI开头的…)，运行中相关的(eg: ACT_RU开头的…)，用户用户组信息相关(eg: ACT_ID开头的…):
   

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

flowable建议采用业界标准BPMN2.0的XML来描述需要定义的工作流。所以我们需要在项目中创建一个流程定义，下面这个是我创建的一个xml定义, 截图不全，源码中有：

看到这里是不是觉得这个文件很复杂，至少对于之前没有用过工作流的我来说看着很复杂的，看不懂。然后在晚上一系列搜索，有的说可以用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下面：

复制过去之后，启动tomcat，上面红线圈起来的文件夹是tomcat启动之后自动解压生成的：

启动过程可能有点慢，要全部启动flowable的这几个服务，看到下面这个就启动完成了：

启动成功之后，可以登陆创建流程：http://localhost:8080/flowable-ui/
密码是：test

可以开始创建：

这个就是我创建的一个流程：

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

创建完成之后：可以导出BPMN2:

可以打开下载的文件，自动转成xml格式，是不是很方便，不用自己全部写：

然后再把这个下载文件拷贝项目中： resources/processes/ 目录下：

然后可以在Controller文件中创建接口测试这个工作流：

这些是我引入的flowable相关的，接下来创建流程：

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

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

接下来可以在postman中测试一下：

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

然后可以创建显示流程图的接口：

在postman中传入流程id测试一下：

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

接着创建审批通过接口：

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

接着我们再测试一下，可以看到审批通过：

再看一下流程图：

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

我们可以查询一个指定用户/用户组的任务列表：

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

上面可以看到流程已经到了firstApprovedTask节点，说明只有first用户组才可以查询或执行。我们再测试一下：

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

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

包括：

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

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

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

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