Springboot结合Flowable实现工作流开发

公司内部的oa系统最近要升级改造，由于人手不够就把我借调过去了，但说真的我还没做过这方面的功能，第一次接触工作流的开发，还是有点好奇是个怎样的流程。

项目主要用 springboot + flowable 重构原有的工作流程，flowable 是个用 java语言写的轻量级工作流引擎，上手比较简单开发效率也挺高的，一起学习下这个框架。

官方地址：https://www.flowable.org/docs/userguide/index.html，分享的只是简单应用，深入研究还得看官方文档。

flowable 核心依赖

<!--flowable工作流依赖-->
<dependency>
	<groupid>org.flowable</groupid>
	<artifactid>flowable-spring-boot-starter</artifactid>
	<version>6.3.0</version>
</dependency>
<dependency>
	<groupid>org.springframework.boot</groupid>
	<artifactid>spring-boot-starter-jdbc</artifactid>
</dependency>
<dependency>
	<groupid>org.springframework.boot</groupid>
	<artifactid>spring-boot-starter-web</artifactid>
</dependency>
<dependency>
	<groupid>org.mybatis.spring.boot</groupid>
	<artifactid>mybatis-spring-boot-starter</artifactid>
	<version>1.3.2</version>
</dependency>
<dependency>
	<groupid>mysql</groupid>
	<artifactid>mysql-connector-java</artifactid>
	<scope>runtime</scope>
</dependency>

流程设计

工作流开发的核心是任务流程的设计，flowable 官方建议采用业界标准bpmn2.0的 xml来描述需要定义的工作流。

我们需要在 resource 目录下创建 processes路径，存放相关的 xml流程配置文件。flowable 框架会默认加载此目录下的工作流文件并解析 xml，并将解析后的流程配置信息持久化到数据库。

flowable 是依赖于数据库的，但它并不需要我们手动的创建表，而是在程序第一次启动时，自动的向mysql 中创建它所需要的一系列表。

spring:
  datasource:
    url: jdbc:mysql://47.93.6.5:3306/order?servertimezone=utc
    username: root
    password: 123455

看到项目启动成功一共生成了60个表，数量还是比较多的，建议使用专门的数据库存在这些工作流表。

举个栗子：假如一个请假流程，需要经理审核通过，请假才能生效，如果他驳回流程结束。

接下来我们用 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: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="leave" name="leaveprocess" isexecutable="true">
        <usertask id="leavetask" name="请假" flowable:assignee="${leavetask}"/>
        <usertask id="managertask" name="经理审核"/>
        <exclusivegateway id="managerjudgetask"/>
        <endevent id="endleave" name="结束"/>
        <startevent id="startleave" name="开始"/>
        <sequenceflow id="modeflow" sourceref="leavetask" targetref="managertask"/>
        <sequenceflow id="flowstart" sourceref="startleave" targetref="leavetask"/>
        <sequenceflow id="jugdeflow" sourceref="managertask" targetref="managerjudgetask"/>
        <endevent id="endleave2"/>
        <sequenceflow id="flowend" name="通过" sourceref="managerjudgetask" targetref="endleave">
            <conditionexpression xsi:type="tformalexpression">
                <![cdata[${checkresult=='通过'}]]>
            </conditionexpression>
        </sequenceflow>
        <sequenceflow id="rejectflow" name="驳回" sourceref="managerjudgetask"
                      targetref="endleave2">
            <conditionexpression xsi:type="tformalexpression">
                <![cdata[${checkresult=='驳回'}]]>
            </conditionexpression>
        </sequenceflow>
    </process>
    <bpmndi:bpmndiagram id="bpmndiagram_process">
        <bpmndi:bpmnplane bpmnelement="leave" id="bpmnplane_process">
            <bpmndi:bpmnshape bpmnelement="leavetask" id="bpmnshape_leavetask">
                <omgdc:bounds height="79.99999999999999" width="100.0" x="304.60807973558974" y="122.00000000000001"/>
            </bpmndi:bpmnshape>
            <bpmndi:bpmnshape bpmnelement="managertask" id="bpmnshape_managertask">
                <omgdc:bounds height="80.0" width="100.0" x="465.0" y="122.0"/>
            </bpmndi:bpmnshape>
            <bpmndi:bpmnshape bpmnelement="managerjudgetask" id="bpmnshape_managerjudgetask">
                <omgdc:bounds height="40.0" width="40.0" x="611.5" y="142.0"/>
            </bpmndi:bpmnshape>
            <bpmndi:bpmnshape bpmnelement="endleave" id="bpmnshape_endleave">
                <omgdc:bounds height="28.0" width="28.0" x="696.5" y="148.0"/>
            </bpmndi:bpmnshape>
            <bpmndi:bpmnshape bpmnelement="startleave" id="bpmnshape_startleave">
                <omgdc:bounds height="30.0" width="30.0" x="213.2256558149128" y="147.0"/>
            </bpmndi:bpmnshape>
            <bpmndi:bpmnshape bpmnelement="endleave2"
                              id="bpmnshape_endleave2">
                <omgdc:bounds height="28.0" width="28.0" x="617.5" y="73.32098285753572"/>
            </bpmndi:bpmnshape>
            <bpmndi:bpmnedge bpmnelement="flowend" id="bpmnedge_flowend">
                <omgdi:waypoint x="651.1217948717949" y="162.37820512820514"/>
                <omgdi:waypoint x="696.5002839785394" y="162.0891701657418"/>
            </bpmndi:bpmnedge>
            <bpmndi:bpmnedge bpmnelement="rejectflow" id="bpmnedge_rejectflow">
                <omgdi:waypoint x="631.866093577786" y="142.36609357778607" />
                <omgdi:waypoint x="631.5931090276993" y="101.32067323657485" />
            </bpmndi:bpmnedge>
            <bpmndi:bpmnedge bpmnelement="modeflow" id="bpmnedge_modeflow">
                <omgdi:waypoint x="404.60807973558974" y="162.0" />
                <omgdi:waypoint x="465.0" y="162.0" />
            </bpmndi:bpmnedge>
            <bpmndi:bpmnedge bpmnelement="flowstart" id="bpmnedge_flowstart">
                <omgdi:waypoint x="243.2256558149128" y="162.0" />
                <omgdi:waypoint x="304.60807973558974" y="162.0" />
            </bpmndi:bpmnedge>
            <bpmndi:bpmnedge bpmnelement="jugdeflow" id="bpmnedge_jugdeflow">
                <omgdi:waypoint x="565.0" y="162.21367521367523" />
                <omgdi:waypoint x="611.9141630901288" y="162.41416309012877" />
            </bpmndi:bpmnedge>
        </bpmndi:bpmnplane>
    </bpmndi:bpmndiagram>
</definitions>

其实就是把流程图的各种线条逻辑，用不同的xml标签描绘出来了。

• <process> ： 表示一个完整的工作流
• <documentation> ： 对工作流的描述
• <startevent> ： 工作流中起点位置（开始）
• <endevent > ： 工作流中结束位置（结束）
• <usertask> ： 代表一个任务审核节点（组长、经理等角色）
• <exclusivegateway> ： 逻辑判断节点，相当于流程图中的菱形框
• <sequenceflow> ：链接各个节点的线条，sourceref 属性表示线的起始节点，targetref 属性表示线指向的节点。

上边这一大坨xml是不是看着超级麻烦，要是有自动生成工具就好了，我发现idea自带设计工具，但实在是太难用了。

作为一个面向百度编程的程序员，别的不行上网找答案的能力还是可以的，既然我都觉得写xml麻烦，那么想来官方肯定也想到了，说不定有现成的工具，逛了一圈官网https://www.flowable.org/downloads.html ，居然真的找到了。

github下载地址：https://github.com/flowable/flowable-engine/releases/download/flowable-6.4.0/flowable-6.4.0.zip，下载速度那是相当感人，而且这个工具需要自己安装.......

又找了个在线编辑的工具

流程审批

流程设计完后剩下的就是对工作流的审批和生成流程图。

首先启动一个请假的流程，以员工id staffid 作为唯一标识，xml文件中会接收变量 leavetask，flowable内部会进行数据库持久化，并返回一个流程id processid ，用它可以查询工作流的整体情况，任务id task为员工具体的请假任务。

注意：一个请假流程 processid中可以包含多个请假任务 taskid。

/**
     * @author xiaofu
     * @description 启动流程
     * @date 2020/8/26 17:36
     */
    @requestmapping(value = "startleaveprocess")
    @responsebody
    public string startleaveprocess(string staffid) {
        hashmap<string, object> map = new hashmap<>();
        map.put("leavetask", staffid);
        processinstance processinstance = runtimeservice.startprocessinstancebykey("leave", map);
        stringbuilder sb = new stringbuilder();
        sb.append("创建请假流程 processid：" + processinstance.getid());
        list<task> tasks = taskservice.createtaskquery().taskassignee(staffid).orderbytaskcreatetime().desc().list();
        for (task task : tasks) {
            sb.append("任务taskid:" + task.getid());
        }
        return sb.tostring();
    }

用启动流程时返回的 processid 看一下一下当前的流程图

http://localhost:4000/leave/createprocessdiagrampic?processid=37513

接下来将请假申请进行驳回 ，传入相应的 taskid 后执行驳回，再看看整个工作流的效果。

http://localhost:4000/leave/rejecttask?taskid=10086

 /**
     * @param taskid
     * @author xinzhifu
     * @description 驳回
     * @date 2020/8/27 14:30
     */
    @responsebody
    @requestmapping(value = "rejecttask")
    public string rejecttask(string taskid) {
        hashmap<string, object> map = new hashmap<>();
        map.put("checkresult", "驳回");
        taskservice.complete(taskid, map);
        return "申请审核驳回~";
    }

看到整个请假流程在经理审核这成功阻断了。

http://localhost:4000/leave/createprocessdiagrampic?processid=37513

总结

开发工作流一般多用在oa系统等传统项目中，我也是第一次尝试做此类功能，收获还是蛮多的，技术栈又压进了一个知识点。今天分享的是个超级简单的demo，因为也是刚开始接触，等我用的贼溜的时候，再给小伙伴们做更成熟更深入的分享。

demo的github 地址:https://github.com/chengxy-nds/springboot-notebook/tree/master/springboot-work-flowable

到此这篇关于springboot结合flowable实现工作流开发 的文章就介绍到这了,更多相关springboot flowable工作流内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持！