真是沒想到,Springboot + Flowable 開發(fā)工作流會這么簡單!
“程序員是塊磚,哪里需要哪里搬。
”
公司內(nèi)部的OA系統(tǒng)最近要升級改造,由于人手不夠就把我借調(diào)過去了,但說真的我還沒做過這方面的功能,第一次接觸工作流的開發(fā),還是有點(diǎn)好奇是個(gè)怎樣的流程。
項(xiàng)目主要用 Springboot+
Flowable重構(gòu)原有的工作流程,
Flowable是個(gè)用
Java語言寫的輕量級工作流引擎,上手比較簡單開發(fā)效率也挺高的,一起學(xué)習(xí)下這個(gè)框架。
官方地址:
https://www.flowable.org/docs/userguide/index.html,分享的只是簡單應(yīng)用,深入研究還得看官方文檔。
Flowable 核心依賴
Flowable 核心依賴
<dependency> <groupId>org.flowablegroupId> <artifactId>flowable-spring-boot-starterartifactId> <version>6.3.0version> dependency> <dependency> <groupId>org.springframework.bootgroupId> <artifactId>spring-boot-starter-jdbcartifactId> dependency> <dependency> <groupId>org.springframework.bootgroupId> <artifactId>spring-boot-starter-webartifactId> dependency> <dependency> <groupId>org.mybatis.spring.bootgroupId> <artifactId>mybatis-spring-boot-starterartifactId> <version>1.3.2version> dependency> <dependency> <groupId>mysqlgroupId> <artifactId>mysql-connector-javaartifactId> <scope>runtimescope> dependency>
流程設(shè)計(jì)
工作流開發(fā)的核心是任務(wù)流程的設(shè)計(jì),Flowable官方建議采用業(yè)界標(biāo)準(zhǔn)BPMN2.0的 XML來描述需要定義的工作流。
我們需要在 resource目錄下創(chuàng)建 processes路徑,存放相關(guān)的 XML流程配置文件。Flowable框架會默認(rèn)加載此目錄下的工作流文件并解析 XML,并將解析后的流程配置信息持久化到數(shù)據(jù)庫。
Flowable是依賴于數(shù)據(jù)庫的,但它并不需要我們手動的創(chuàng)建表,而是在程序第一次啟動時(shí),自動的向MySQL中創(chuàng)建它所需要的一系列表。
spring:
datasource:
url: jdbc:mysql://47.93.6.5:3306/order?serverTimezone=UTC username: root
password: 123455
看到項(xiàng)目啟動成功一共生成了60個(gè)表,數(shù)量還是比較多的,建議使用專門的數(shù)據(jù)庫存在這些工作流表。
舉個(gè)栗子:假如一個(gè)請假流程,需要經(jīng)理審核通過,請假才能生效,如果他駁回流程結(jié)束。
接下來我們用 XML翻譯下上邊的請假流程圖,整體非常簡單只要夠細(xì)心就行了,一起看看每個(gè)標(biāo)簽都是什么含義。
"1.0" encoding="UTF-8"?>"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">
"Leave" name="LeaveProcess" isExecutable="true">
"leaveTask" name="請假" flowable:assignee="${leaveTask}"/>
"managerTask" name="經(jīng)理審核"/>
"managerJudgeTask"/>
"endLeave" name="結(jié)束"/>
"startLeave" name="開始"/>
"modeFlow" sourceRef="leaveTask" targetRef="managerTask"/>
"flowStart" sourceRef="startLeave" targetRef="leaveTask"/>
"jugdeFlow" sourceRef="managerTask" targetRef="managerJudgeTask"/>
"endLeave2"/>
"flowEnd" name="通過" sourceRef="managerJudgeTask" targetRef="endLeave">
"tFormalExpression">
'通過'}]]>"rejectFlow" name="駁回" sourceRef="managerJudgeTask" targetRef="endLeave2">
"tFormalExpression">
'駁回'}]]>"BPMNDiagram_process">
"Leave" id="BPMNPlane_process">
"leaveTask" id="BPMNShape_leaveTask">
"79.99999999999999" width="100.0" x="304.60807973558974" y="122.00000000000001"/>"managerTask" id="BPMNShape_managerTask">
"80.0" width="100.0" x="465.0" y="122.0"/>"managerJudgeTask" id="BPMNShape_managerJudgeTask">
"40.0" width="40.0" x="611.5" y="142.0"/>"endLeave" id="BPMNShape_endLeave">
"28.0" width="28.0" x="696.5" y="148.0"/>"startLeave" id="BPMNShape_startLeave">
"30.0" width="30.0" x="213.2256558149128" y="147.0"/>"endLeave2" id="BPMNShape_endLeave2">
"28.0" width="28.0" x="617.5" y="73.32098285753572"/>"flowEnd" id="BPMNEdge_flowEnd">
"651.1217948717949" y="162.37820512820514"/>
"696.5002839785394" y="162.0891701657418"/>"rejectFlow" id="BPMNEdge_rejectFlow">
"631.866093577786" y="142.36609357778607" />
"631.5931090276993" y="101.32067323657485" />"modeFlow" id="BPMNEdge_modeFlow">
"404.60807973558974" y="162.0" />
"465.0" y="162.0" />"flowStart" id="BPMNEdge_flowStart">
"243.2256558149128" y="162.0" />
"304.60807973558974" y="162.0" />"jugdeFlow" id="BPMNEdge_jugdeFlow">
"565.0" y="162.21367521367523" />
"611.9141630901288" y="162.41416309012877" />
其實(shí)就是把流程圖的各種線條邏輯,用不同的XML標(biāo)簽描繪出來了。
:表示一個(gè)完整的工作流
:對工作流的描述
:工作流中起點(diǎn)位置(開始)
:工作流中結(jié)束位置(結(jié)束)
:代表一個(gè)任務(wù)審核節(jié)點(diǎn)(組長、經(jīng)理等角色)
:邏輯判斷節(jié)點(diǎn),相當(dāng)于流程圖中的菱形框
:鏈接各個(gè)節(jié)點(diǎn)的線條,sourceRef屬性表示線的起始節(jié)點(diǎn),targetRef屬性表示線指向的節(jié)點(diǎn)。
上邊這一大坨XML是不是看著超級麻煩,要是有自動生成工具就好了,我發(fā)現(xiàn)IDEA自帶設(shè)計(jì)工具,但實(shí)在是太難用了。
作為一個(gè)面向百度編程的程序員,別的不行上網(wǎng)找答案的能力還是可以的,既然我都覺得寫XML麻煩,那么想來官方肯定也想到了,說不定有現(xiàn)成的工具,逛了一圈官網(wǎng)https://www.flowable.org/downloads.html,居然真的找到了。
github下載地址:https://github.com/flowable/flowable-engine/releases/download/flowable-6.4.0/flowable-6.4.0.zip,下載速度那是相當(dāng)感人,而且這個(gè)工具需要自己安裝.......
又找了個(gè)在線編輯的工具:http://www.learun.cn:8090/home_online.htm,各種折騰~,設(shè)計(jì)完流程后,直接復(fù)制自動生成的代碼即可。
流程審批
流程設(shè)計(jì)完后剩下的就是對工作流的審批和生成流程圖。
首先啟動一個(gè)請假的流程,以員工ID staffId作為唯一標(biāo)識,XML文件中會接收變量 leaveTask,Flowable內(nèi)部會進(jìn)行數(shù)據(jù)庫持久化,并返回一個(gè)流程Id processId,用它可以查詢工作流的整體情況,任務(wù)Id task為員工具體的請假任務(wù)。
注意:一個(gè)請假流程 processId中可以包含多個(gè)請假任務(wù) 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("創(chuàng)建請假流程 processId:" + processInstance.getId());
Listtasks = taskService.createTaskQuery().taskAssignee(staffId).orderByTaskCreateTime().desc().list(); for (Task task : tasks) {
sb.append("任務(wù)taskId:" + task.getId());
} return sb.toString();
}
用啟動流程時(shí)返回的 processId看一下一下當(dāng)前的流程圖
http://localhost:4000/leave/createProcessDiagramPic?processId=37513
接下來將請假申請進(jìn)行駁回 ,傳入相應(yīng)的 taskId后執(zhí)行駁回,再看看整個(gè)工作流的效果。
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 "申請審核駁回~";
}
看到整個(gè)請假流程在經(jīng)理審核這成功阻斷了。
http://localhost:4000/leave/createProcessDiagramPic?processId=37513
總結(jié)
開發(fā)工作流一般多用在OA系統(tǒng)等傳統(tǒng)項(xiàng)目中,我也是第一次嘗試做此類功能,收獲還是蠻多的,技術(shù)棧又壓進(jìn)了一個(gè)知識點(diǎn)。今天分享的是個(gè)超級簡單的demo,因?yàn)橐彩莿傞_始接觸,等我用的賊溜的時(shí)候,再給小伙伴們做更成熟更深入的分享。
demo的github地址:https://github.com/chengxy-nds/Springboot-Notebook/tree/master/springboot-work-flowable
免責(zé)聲明:本文內(nèi)容由21ic獲得授權(quán)后發(fā)布,版權(quán)歸原作者所有,本平臺僅提供信息存儲服務(wù)。文章僅代表作者個(gè)人觀點(diǎn),不代表本平臺立場,如有問題,請聯(lián)系我們,謝謝!