真是沒想到 Springboot + Flowable 工作流開發會這麼簡單
阿新 • • 發佈:2020-08-28
>本文收錄在個人部落格:[www.chengxy-nds.top](http://www.chengxy-nds.top),技術資料共享,同進步
**程式設計師是塊磚,哪裡需要哪裡搬**
公司內部的OA系統最近要升級改造,由於人手不夠就把我借調過去了,但說真的我還沒做過這方面的功能,第一次接觸工作流的開發,還是有點好奇是個怎樣的流程。
專案主要用 `Springboot` + `Flowable` 重構原有的工作流程,`Flowable` 是個用 `Java`語言寫的輕量級工作流引擎,上手比較簡單開發效率也挺高的,一起學習下這個框架。
官方地址:`https://www.flowable.org/docs/userguide/index.html`,分享的只是簡單應用,深入研究還得看官方文件。
## Flowable 核心依賴
```javascript
org.flowable
flowable-spring-boot-starter
6.3.0
org.springframework.boot
spring-boot-starter-jdbc
org.springframework.boot
spring-boot-starter-web
org.mybatis.spring.boot
mybatis-spring-boot-starter
1.3.2
mysql
mysql-connector-java
runtime
```
## 流程設計
工作流開發的核心是任務流程的設計,`Flowable` 官方建議採用業界標準`BPMN2.0`的 `XML`來描述需要定義的工作流。
我們需要在 `resource` 目錄下建立 `processes`路徑,存放相關的 `XML`流程配置檔案。`Flowable` 框架會預設載入此目錄下的工作流檔案並解析 `XML`,並將解析後的流程配置資訊持久化到資料庫。
![](https://img-blog.csdnimg.cn/20200827111825323.png)
`Flowable` 是依賴於資料庫的,但它並不需要我們手動的建立表,而是在程式第一次啟動時,自動的向`MySQL` 中建立它所需要的一系列表。
```javascript
spring:
datasource:
url: jdbc:mysql://47.93.6.5:3306/order?serverTimezone=UTC
username: root
password: 123455
```
![](https://img-blog.csdnimg.cn/20200826152345138.png)
看到專案啟動成功一共生成了60個表,數量還是比較多的,建議使用專門的資料庫存在這些工作流表。
![](https://img-blog.csdnimg.cn/20200826152402283.png)
舉個栗子:假如一個請假流程,需要經理稽核通過,請假才能生效,如果他駁回流程結束。
![](https://img-blog.csdnimg.cn/20200827164539573.png#pic_center)
接下來我們用 `XML` 翻譯下上邊的請假流程圖,整體非常簡單隻要夠細心就行了,一起看看每個標籤都是什麼含義。
```java
```
其實就是把流程圖的各種線條邏輯,用不同的`XML`標籤描繪出來了。
`` : 表示一個完整的工作流
`` : 對工作流的描述
`` : 工作流中起點位置(開始)
`` : 工作流中結束位置(結束)
`` : 代表一個任務稽核節點(組長、經理等角色)
`` : 邏輯判斷節點,相當於流程圖中的菱形框
`` :連結各個節點的線條,`sourceRef` 屬性表示線的起始節點,`targetRef` 屬性表示線指向的節點。
上邊這一大坨`XML`是不是看著超級麻煩,要是有自動生成工具就好了,我發現`IDEA`自帶設計工具,但實在是太難用了。
![](https://img-blog.csdnimg.cn/20200827154808132.png)
作為一個面向百度程式設計的程式設計師,別的不行上網找答案的能力還是可以的,既然我都覺得寫`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,下載速度那是相當感人,而且這個工具需要自己安裝.......
![](https://img-blog.csdnimg.cn/20200827171441437.png)
又找了個線上編輯的工具: http://learun.cn:8090/home_online.htm,各種折騰~,設計完流程後,直接複製自動生成的程式碼即可。
![](https://img-blog.csdnimg.cn/20200827171617712.png)
## 流程審批
流程設計完後剩下的就是對工作流的審批和生成流程圖。
首先啟動一個請假的流程,以員工ID `staffId` 作為唯一標識,`XML`檔案中會接收變數 `leaveTask`,`Flowable`內部會進行資料庫持久化,並返回一個流程Id `processId` ,用它可以查詢工作流的整體情況,任務Id `task`為員工具體的請假任務。
**注意**:一個請假流程 `processId`中可以包含多個請假任務 `taskId`。
```javascript
/**
* @author xiaofu
* @description 啟動流程
* @date 2020/8/26 17:36
*/
@RequestMapping(value = "startLeaveProcess")
@ResponseBody
public String startLeaveProcess(String staffId) {
HashMap map = new HashMap<>();
map.put("leaveTask", staffId);
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("Leave", map);
StringBuilder sb = new StringBuilder();
sb.append("建立請假流程 processId:" + processInstance.getId());
List tasks = taskService.createTaskQuery().taskAssignee(staffId).orderByTaskCreateTime().desc().list();
for (Task task : tasks) {
sb.append("任務taskId:" + task.getId());
}
return sb.toString();
}
```
用啟動流程時返回的 `processId` 看一下一下當前的流程圖
```java
http://localhost:4000/leave/createProcessDiagramPic?processId=37513
```
![](https://img-blog.csdnimg.cn/20200827184422961.png#pic_center)
接下來將請假申請進行駁回 ,傳入相應的 `taskId` 後執行駁回,再看看整個工作流的效果。
```javascript
http://localhost:4000/leave/rejectTask?taskId=10086
```
```javascript
/**
* @param taskId
* @author xinzhifu
* @description 駁回
* @date 2020/8/27 14:30
*/
@ResponseBody
@RequestMapping(value = "rejectTask")
public String rejectTask(String taskId) {
HashMap map = new HashMap<>();
map.put("checkResult", "駁回");
taskService.complete(taskId, map);
return "申請稽核駁回~";
}
```
看到整個請假流程在經理稽核這成功阻斷了。
```javascript
http://localhost:4000/leave/createProcessDiagramPic?processId=37513
```
![](https://img-blog.csdnimg.cn/20200827185029709.png#pic_center)
## 總結
開發工作流一般多用在OA系統等傳統專案中,我也是第一次嘗試做此類功能,收穫還是蠻多的,技術棧又壓進了一個知識點。今天分享的是個超級簡單的`demo`,因為也是剛開始接觸,等我用的賊溜的時候,再給小夥伴們做更成熟更深入的分享。
`demo`的`github` 地址:`https://github.com/chengxy-nds/Springboot-Notebook/tree/master/springboot-work-flowable`
---
**原創不易,燃燒秀髮輸出內容,如果有一丟丟收穫,點個贊鼓勵一下吧!**
整理了幾百本各類技術電子書,送給小夥伴們。關注公號回覆【**666**】自行領取。和一些小夥伴們建了一個技術交流群,一起探討技術、分享技術資料,旨在共同學習進步,如果感興趣就加入我們吧!
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200828110008952.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hpbnpoaWZ1MQ==,size_16,color_FFFFFF,t_70#pic_center)