本文收錄在個人部落格：www.chengxy-nds.top，技術資料共享，同進步
程式設計師是塊磚，哪裡需要哪裡搬
公司內部的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，下載速度那是相當感人，而且這個工具需要自己安裝…….
又找了個線上編輯的工具： 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，因為也是剛開始接觸，等我用的賊溜的時候，再給小夥伴們做更成熟更深入的分享。
demo的github 地址:https://github.com/chengxy-nds/Springboot-Notebook/tree/master/springboot-work-flowable
原創不易，燃燒秀髮輸出內容，如果有一丟丟收穫，點個贊鼓勵一下吧！
整理了幾百本各類技術電子書，送給小夥伴們。關注公號回覆【666】自行領取。和一些小夥伴們建了一個技術交流群，一起探討技術、分享技術資料，旨在共同學習進步，如果感興趣就加入我們吧！
本作品採用《CC 協議》，轉載必須註明作者和本文連結