springBoot集成Activiti6

數據庫:mysql

IDE:Spring Tool Suite

build工具:Maven

項目版本:springBoot1.5.10 + JDK1.8 + Maven3.0.5
(之前用的是2.0.0版本的springBoot,集成activiti6後啓動一直報錯,最後發現是版本問題,改爲1.5.10就可以了,迷之崩潰o(╥﹏╥)o)

一.構建springBoot

1.創建項目

(1)使用idea創建springboot項目很快,可參考如下鏈接:
https://www.cnblogs.com/winner-0715/p/6666302.html

(2)使用eclipse安裝STS插件的方式,參考鏈接:
https://blog.csdn.net/clementad/article/details/51334064
(可能我的eclipse比較調皮,STS插件安裝一直沒配置成功,so~我直接下載了STS~)

(3)STS下載地址:
http://spring.io/tools/sts/all

使用STS創建項目:

新建項目–選擇Spring Boot下的Spring Starter Project–Next

這裏寫圖片描述
這裏寫圖片描述
選擇SpringBoot的版本:
這裏寫圖片描述
創建成功後的目錄結構:
這裏寫圖片描述
給pom.xml添加以下依賴:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

2.運行項目

找到整個項目的入口類:MiaoApplication
這裏寫圖片描述
這個類有一個@SpringBootApplication註解,這是整個Spring Boot的核心註解,它的目的就是開啓Spring Boot的自動配置。需要在這個類上再添加一個@RestController註解,使之變爲一個Controller,然後裏邊提供一個地址轉換方法,如下:

@RestController
@SpringBootApplication 
public class MiaoApplication {
public static void main(String[] args){ 
SpringApplication.run(MiaoApplication.class, args); 
} 
@GetMapping(value = "/") 
String index(){
return "Hello Spring Boot!"; 
} 
}

然後運行項目,控制檯沒有報錯信息就說明成功了,在瀏覽器上可以直接訪問:
這裏寫圖片描述

二.Activiti6安裝運行

1.下載和安裝Activiti6

鏈接: https://pan.baidu.com/s/1livSJdUm3doUzBZI5AKJWA
密碼: 2qza
解壓後發現一共有三個子目錄:database,libs,wars,各個目錄的作用描述如下:
這裏寫圖片描述
2.使用tomcat配置與運行

wars目錄下的三個war包默認使用的是h2內存數據庫,重啓服務器數據就會消失。將3個war包複製到tomcat的webapps的目錄下,更改tomcat的server.xml文件的Context 爲:

<Context docBase="F:\apache-tomcat-7.0.59\webapps\activiti-app.war" path="/" reloadable="true"/>

然後雙擊bin目錄下的startup.bat文件啓動tomcat,打開瀏覽器即可訪問:
(用戶名:admin;密碼:test)
這裏寫圖片描述
PS:如果你的startup.bat雙擊後自動關閉了,有可能和我一樣是java.lang.OutOfMemoryError異常,需要在bin/catalina.bat文件中找到以下一行:

echo Using CATALINA_BASE:   "%CATALINA_BASE%"

在這行的上面添加:

set JAVA_OPTS=%JAVA_OPTS% -server -XX:PermSize=128M -XX:MaxPermSize=512m

重新運行startup.bat即可。

三.Activiti6的使用

Activiti官方發佈的activiti-app可以說是一個較爲完善的樣例,可以通過它來了解Activiti的大部分功能。
登錄成功後,可以看到有三個不同的模塊:

這裏寫圖片描述
這裏寫圖片描述

下面我們以請假爲例,定義一個工作流程。我們知道,請假流程中涉及到的人員有員工和主管,那麼首先需要新建這兩種類型的用戶,之後定義請假流程。

1.新建用戶

點擊Idennity management,進入Users模塊,點擊“Create user”按鈕新建需要請假的員工:
這裏寫圖片描述
2.定義流程

點擊Kickstart app,進入Processes,點擊“Create Process”創建流程。
流程創建完畢會自動進入流程編輯界面,會有提示告訴你怎麼用,超貼心~
通過鼠標拖拉,即可完成一個流程的定義:
這裏寫圖片描述
我們定義了一個開始事件和一個結束事件以及兩個用戶任務,我們需要把用戶任務分配給對應的人員。
點擊第一個用戶任務“提出請假申請”,修改它的“Assignment”屬性,將當前任務分配給Employee:
這裏寫圖片描述
同樣,需要把第二個用戶任務分配給manager。任務分配成功後,點擊左上角的保存按鈕保存當前流程。

3.發佈流程

在activiti-app中,一個App可以包含多個流程模型,因此在發佈流程前,需要新建一個App並設置它的流程模型。
點擊Apps菜單下的“Create App”按鈕,創建App:
這裏寫圖片描述
創建完成後,將之前創建的流程綁定到該App上,之後發佈該App:
這裏寫圖片描述
發佈成功後,使用Employee賬號登錄,可以看到發佈成功的HR App,進入該App,點擊Processes菜單,可以看到“Start a process”按鈕,點擊後即可啓動一個請假流程。
這裏寫圖片描述
啓動後就由employee用戶完成第一個請假申請:
這裏寫圖片描述
之後可登錄manager用戶進行審覈操作,同樣點擊HR App,進入後點擊Processes菜單,以同樣方式操作完成任務後,該流程結束。

四.Spring Tool Suite中使用Activiti6

1.修改配置文件application.properties,保存爲application.yml
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/spring-boot-activiti?useUnicode=true&characterEncoding=utf8&useSSL=false
username: root
password:
jpa:
show-sql: true
記得新建一個對應的數據庫:spring-boot-activiti~

2.在pom.xml中添加Activiti6的依賴

前端使用了thymeleaf模板進行展示,因此也需要引入它的依賴:

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-spring-boot-starter-basic</artifactId>
    <version>6.0.0</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

3.在資源目錄下創建processes目錄

用於保存.bpmn後綴的流程圖,這個目錄名千萬不要手抖打錯了,相信我,程序一定會報錯的~
這裏寫圖片描述
4.安裝Activiti插件
https://blog.csdn.net/qq_33547950/article/details/54926435

5.在processes文件下新建bpmn文件
這裏寫圖片描述
6.使用Activiti插件設計流程圖
這裏寫圖片描述

需要在IDE裏調出properties面板配置參數:

1).General配置Id和文字,注意Id不能重複;
這裏寫圖片描述
2)Main config裏面配置當前任務的代理人Assignee;
這裏寫圖片描述
3)Candidate users可以配置當前任務的候選人組,具體應用場景:
當審覈者有兩個或多個以上,請假申請提交到他們手上後,有一個人認領了該任務,即代表申請被審批通過,這種情況下就需要使用候選人組配置。
這裏寫圖片描述
對於有兩個出口連線的任務,我們通過設置連線flow的流程變量的方式來自動控制流程的流轉:
這裏寫圖片描述
7.編寫流程代碼
這裏寫圖片描述
說明:
1) com.example.MiaoApplication包含了當前demo的主要功能:
登錄;退出;添加請假單;放棄請假;申請請假;審覈請假;獲取請假狀態;獲取請假流程。

2) com.example.controller.MiaoController包含了三個頁面請求,分別爲:
申請人主頁面,審覈人主頁面,請假單填寫頁面;

3) com.example.entity包含了兩個表:
User表:用於存放當前用戶,登錄驗證之前,需要手動在該表內加入信息,示例如下(type爲1代表申請人,2代表審覈人):
這裏寫圖片描述
VacationForm表:用於存放請假信息;

4) com.example.service包含了三個service:
MiaoService:業務流程操作接口;
UserService:用戶表操作接口,繼承了JpaRepository;
VacationFormService:請假表操作接口,繼承了JpaRepository;

5) com.example.serviceImpl中的MiaoServiceImpl是對MiaoService接口的實現。具體細節都標註在了代碼註釋裏,代碼已上傳git:
https://github.com/jichunyang19931023/ActivitiWithSpringBoot

補充:
1.本demo的用戶登錄信息存儲在cookie裏,實際場景下可以考慮存放在Redis裏;
2.數據庫操作使用了SpringData的JpaRepository,實現的時候只需寫一個繼承JpaRepository的類,需要給出實體類名和主鍵類型。
這裏寫圖片描述
3.啓動Spring Boot工程,默認會自動部署相應路徑下流程定義文件;自動創建Activiti ProcessEngine Bean;自動註冊Activiti Service;創建Job Executor。所以我們不用像網上的大多數教程那樣配置引擎,直接使用對應的服務即可:
這裏寫圖片描述

以上配置教程個人原創,有理解不對的地方歡迎提出建議~✿✿ヽ(°▽°)ノ✿

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章