我也沒想到 Springboot + Flowable 開發工做流會這麼簡單

本文收錄在 GitHub 地址 https://github.com/chengxy-nds/Springboot-Notebookjavascript

公司內部的OA系統最近要升級改造，因爲人手不夠就把我借調過去了，但說真的我還沒作過這方面的功能，第一次接觸工做流的開發，仍是有點好奇是個怎樣的流程。html

項目主要用 Springboot + Flowable 重構原有的工做流程，Flowable 是個用 Java語言寫的輕量級工做流引擎，上手比較簡單開發效率也挺高的，一塊兒學習下這個框架。java

官方地址：https://www.flowable.org/docs/userguide/index.html，分享的只是簡單應用，深刻研究還得看官方文檔。mysql

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來描述須要定義的工做流。git

咱們須要在 resource 目錄下建立 processes路徑，存放相關的 XML流程配置文件。Flowable 框架會默認加載此目錄下的工做流文件並解析 XML，並將解析後的流程配置信息持久化到數據庫。程序員

Flowable 是依賴於數據庫的，但它並不須要咱們手動的建立表，而是在程序第一次啓動時，自動的向MySQL 中建立它所須要的一系列表。github

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

看到項目啓動成功一共生成了60個表，數量仍是比較多的，建議使用專門的數據庫存在這些工做流表。web

舉個栗子：假如一個請假流程，須要經理審覈經過，請假才能生效，若是他駁回流程結束。面試

接下來咱們用 XML 翻譯下上邊的請假流程圖，總體很是簡單隻要夠細心就好了，一塊兒看看每一個標籤都是什麼含義。spring

<?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，下載速度那是至關感人，並且這個工具須要本身安裝.......

又找了個在線編輯的工具： http://www.learun.cn:8090/home_online.htm，各類折騰~，設計完流程後，直接複製自動生成的代碼便可。

流程審批

流程設計完後剩下的就是對工做流的審批和生成流程圖。

首先啓動一個請假的流程，以員工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，由於也是剛開始接觸，等我用的賊溜的時候，再給小夥伴們作更成熟更深刻的分享。

整理了幾百本各種技術電子書，有須要的同窗能夠，在我同名公衆號回覆[ 666 ]自取。技術羣快滿了，想進的同窗能夠加我好友，和大佬們一塊兒吹吹技術，期待你的加入。

不管你是剛入行、仍是已經有幾年經驗的程序員，相信這份面試提綱都會給你很多助力，長按二維碼關注『程序員內點事』，回覆『 offer 』自行領取，祝你們 offer 拿到手軟