Springboot+Flowable如何升級(jí)改造OA系統(tǒng)

這篇文章將為大家詳細(xì)講解有關(guān)Springboot+Flowable如何升級(jí)改造OA系統(tǒng)，文章內(nèi)容質(zhì)量較高，因此小編分享給大家做個(gè)參考，希望大家閱讀完這篇文章后對(duì)相關(guān)知識(shí)有一定的了解。

公司內(nèi)部的OA系統(tǒng)最近要升級(jí)改造，由于人手不夠就把我借調(diào)過(guò)去了，但說(shuō)真的我還沒(méi)做過(guò)這方面的功能，第一次接觸工作流的開(kāi)發(fā)，還是有點(diǎn)好奇是個(gè)怎樣的流程。

項(xiàng)目主要用 Springboot + Flowable 重構(gòu)原有的工作流程，Flowable 是個(gè)用 Java語(yǔ)言寫(xiě)的輕量級(jí)工作流引擎，上手比較簡(jiǎn)單開(kāi)發(fā)效率也挺高的，一起學(xué)習(xí)下這個(gè)框架。

官方地址：https://www.flowable.org/docs/userguide/index.html，分享的只是簡(jiǎn)單應(yīng)用，深入研究還得看官方文檔。

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>

流程設(shè)計(jì)

工作流開(kāi)發(fā)的核心是任務(wù)流程的設(shè)計(jì)，Flowable 官方建議采用業(yè)界標(biāo)準(zhǔn)BPMN2.0的 XML來(lái)描述需要定義的工作流。

我們需要在 resource 目錄下創(chuàng)建 processes路徑，存放相關(guān)的 XML流程配置文件。Flowable 框架會(huì)默認(rèn)加載此目錄下的工作流文件并解析 XML，并將解析后的流程配置信息持久化到數(shù)據(jù)庫(kù)。

Flowable 是依賴于數(shù)據(jù)庫(kù)的，但它并不需要我們手動(dòng)的創(chuàng)建表，而是在程序第一次啟動(dòng)時(shí)，自動(dòng)的向MySQL 中創(chuàng)建它所需要的一系列表。

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

看到項(xiàng)目啟動(dòng)成功一共生成了60個(gè)表，數(shù)量還是比較多的，建議使用專(zhuān)門(mén)的數(shù)據(jù)庫(kù)存在這些工作流表。

舉個(gè)栗子：假如一個(gè)請(qǐng)假流程，需要經(jīng)理審核通過(guò)，請(qǐng)假才能生效，如果他駁回流程結(jié)束。

接下來(lái)我們用 XML 翻譯下上邊的請(qǐng)假流程圖，整體非常簡(jiǎn)單只要夠細(xì)心就行了，一起看看每個(gè)標(biāo)簽都是什么含義。

<?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="請(qǐng)假" flowable:assignee="${leaveTask}"/>
        <userTask id="managerTask" name="經(jīng)理審核"/>
        <exclusiveGateway id="managerJudgeTask"/>
        <endEvent id="endLeave" name="結(jié)束"/>
        <startEvent id="startLeave" name="開(kāi)始"/>
        <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="通過(guò)" sourceRef="managerJudgeTask" targetRef="endLeave">
            <conditionExpression xsi:type="tFormalExpression">
                <![CDATA[${checkResult=='通過(guò)'}]]>
            </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>

其實(shí)就是把流程圖的各種線條邏輯，用不同的XML標(biāo)簽描繪出來(lái)了。

<process> ： 表示一個(gè)完整的工作流

<documentation> ： 對(duì)工作流的描述

<startEvent> ： 工作流中起點(diǎn)位置（開(kāi)始）

<endEvent > ： 工作流中結(jié)束位置（結(jié)束）

<userTask> ： 代表一個(gè)任務(wù)審核節(jié)點(diǎn)（組長(zhǎng)、經(jīng)理等角色）

<exclusiveGateway> ： 邏輯判斷節(jié)點(diǎn)，相當(dāng)于流程圖中的菱形框

<sequenceFlow> ：鏈接各個(gè)節(jié)點(diǎn)的線條，sourceRef 屬性表示線的起始節(jié)點(diǎn)，targetRef 屬性表示線指向的節(jié)點(diǎn)。

上邊這一大坨XML是不是看著超級(jí)麻煩，要是有自動(dòng)生成工具就好了，我發(fā)現(xiàn)IDEA自帶設(shè)計(jì)工具，但實(shí)在是太難用了。

作為一個(gè)面向百度編程的程序員，別的不行上網(wǎng)找答案的能力還是可以的，既然我都覺(jué)得寫(xiě)XML麻煩，那么想來(lái)官方肯定也想到了，說(shuō)不定有現(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ù)制自動(dòng)生成的代碼即可。

流程審批

流程設(shè)計(jì)完后剩下的就是對(duì)工作流的審批和生成流程圖。

首先啟動(dòng)一個(gè)請(qǐng)假的流程，以員工ID staffId 作為唯一標(biāo)識(shí)，XML文件中會(huì)接收變量 leaveTask，Flowable內(nèi)部會(huì)進(jìn)行數(shù)據(jù)庫(kù)持久化，并返回一個(gè)流程Id processId ，用它可以查詢工作流的整體情況，任務(wù)Id task為員工具體的請(qǐng)假任務(wù)。

注意：一個(gè)請(qǐng)假流程 processId中可以包含多個(gè)請(qǐng)假任務(wù) taskId。

/**
     * @author xiaofu
     * @description 啟動(dòng)流程
     * @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)建請(qǐng)假流程 processId：" + processInstance.getId());
        List<Task> tasks = taskService.createTaskQuery().taskAssignee(staffId).orderByTaskCreateTime().desc().list();
        for (Task task : tasks) {
            sb.append("任務(wù)taskId:" + task.getId());
        }
        return sb.toString();
    }

用啟動(dòng)流程時(shí)返回的 processId 看一下一下當(dāng)前的流程圖

http://localhost:4000/leave/createProcessDiagramPic?processId=37513

接下來(lái)將請(qǐng)假申請(qǐng)進(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 "申請(qǐng)審核駁回~";
    }

看到整個(gè)請(qǐng)假流程在經(jīng)理審核這成功阻斷了。

http://localhost:4000/leave/createProcessDiagramPic?processId=37513

總結(jié)

開(kāi)發(fā)工作流一般多用在OA系統(tǒng)等傳統(tǒng)項(xiàng)目中，我也是第一次嘗試做此類(lèi)功能，收獲還是蠻多的，技術(shù)棧又壓進(jìn)了一個(gè)知識(shí)點(diǎn)。

關(guān)于Springboot+Flowable如何升級(jí)改造OA系統(tǒng)就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，可以學(xué)到更多知識(shí)。如果覺(jué)得文章不錯(cuò)，可以把它分享出去讓更多的人看到。