在springBoot專案中使用activiti
原文以及原始碼請檢視作者部落格:
http://www.jvm123.com/2019/08/springboot-activiti/
依賴:
新建springBoot專案時勾選activiti,或者在已建立的springBoot專案新增以下依賴:
<dependency> <groupId>org.activiti</groupId> <artifactId>activiti-spring-boot-starter-basic</artifactId> <version>6.0.0</version> </dependency>
配置:
資料來源和activiti配置:
server: port: 8081 spring: datasource: url: jdbc:mysql://localhost:3306/act5?useSSL=true driver-class-name: com.mysql.jdbc.Driver username: root password: root # activiti default configuration activiti: database-schema-update: true check-process-definitions: true process-definition-location-prefix: classpath:/processes/ # process-definition-location-suffixes: # - **.bpmn # - **.bpmn20.xml history-level: full
在activiti的預設配置中,process-definition-location-prefix 是指定activiti流程描述檔案的字首(即路徑),啟動時,activiti就會去尋找此路徑下的流程描述檔案,並且自動部署;suffix 是一個String陣列,表示描述檔案的預設字尾名,預設以上兩種。
springMVC配置:
package com.yawn.config; import org.springframework.context.annotation.Configuration; import org.springframework.format.FormatterRegistry; import org.springframework.http.HttpStatus; import org.springframework.web.servlet.config.annotation.*; /** * Created by yawn on 2017/8/5. */ @EnableWebMvc @Configuration public class MvcConfig extends WebMvcConfigurerAdapter { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/"); registry.addResourceHandler("/templates/**").addResourceLocations("classpath:/templates/"); super.addResourceHandlers(registry); } @Override public void addViewControllers(ViewControllerRegistry registry) { registry.addViewController("/index"); registry.addViewController("/user"); registry.addRedirectViewController("/","/templates/login.html"); // registry.addStatusController("/403", HttpStatus.FORBIDDEN); super.addViewControllers(registry); } }
這裡配置靜態資源和直接訪問的頁面: 在本示例專案中,添加了thymeleaf依賴解析檢視,主要採用非同步方式獲取資料,通過angularJS進行前端資料的處理和展示。
使用activiti:
配置了資料來源和activiti後,啟動專案,activiti 的各個服務元件就已經被加入到spring容器中了,所以就可以直接注入使用了。如果在未自動配置的spring環境中,可以使用通過指定bean的init-method來配置activiti的服務元件。
案例:
以以下請假流程為例:
1. 開始流程並“申請請假”(員工)
private static final String PROCESS_DEFINE_KEY = "vacationProcess";
public Object startVac(String userName, Vacation vac) {
identityService.setAuthenticatedUserId(userName);
// 開始流程
ProcessInstance vacationInstance = runtimeService.startProcessInstanceByKey(PROCESS_DEFINE_KEY);
// 查詢當前任務
Task currentTask = taskService.createTaskQuery().processInstanceId(vacationInstance.getId()).singleResult();
// 申明任務
taskService.claim(currentTask.getId(), userName);
Map<String, Object> vars = new HashMap<>(4);
vars.put("applyUser", userName);
vars.put("days", vac.getDays());
vars.put("reason", vac.getReason());
// 完成任務
taskService.complete(currentTask.getId(), vars);
return true;
}
在此方法中,Vaction 是申請時的具體資訊,在完成“申請請假”任務時,可以將這些資訊設定成引數。
2. 審批請假(老闆)
(1)查詢需要自己審批的請假
public Object myAudit(String userName) {
List<Task> taskList = taskService.createTaskQuery().taskCandidateUser(userName)
.orderByTaskCreateTime().desc().list();
// / 多此一舉 taskList中包含了以下內容(使用者的任務中包含了所在使用者組的任務)
// Group group = identityService.createGroupQuery().groupMember(userName).singleResult();
// List<Task> list = taskService.createTaskQuery().taskCandidateGroup(group.getId()).list();
// taskList.addAll(list);
List<VacTask> vacTaskList = new ArrayList<>();
for (Task task : taskList) {
VacTask vacTask = new VacTask();
vacTask.setId(task.getId());
vacTask.setName(task.getName());
vacTask.setCreateTime(task.getCreateTime());
String instanceId = task.getProcessInstanceId();
ProcessInstance instance = runtimeService.createProcessInstanceQuery().processInstanceId(instanceId).singleResult();
Vacation vac = getVac(instance);
vacTask.setVac(vac);
vacTaskList.add(vacTask);
}
return vacTaskList;
}
private Vacation getVac(ProcessInstance instance) {
Integer days = runtimeService.getVariable(instance.getId(), "days", Integer.class);
String reason = runtimeService.getVariable(instance.getId(), "reason", String.class);
Vacation vac = new Vacation();
vac.setApplyUser(instance.getStartUserId());
vac.setDays(days);
vac.setReason(reason);
Date startTime = instance.getStartTime(); // activiti 6 才有
vac.setApplyTime(startTime);
vac.setApplyStatus(instance.isEnded() ? "申請結束" : "等待審批");
return vac;
}
package com.yawn.entity;
import java.util.Date;
/**
* @author Created by yawn on 2018-01-09 14:31
*/
public class VacTask {
private String id;
private String name;
private Vacation vac;
private Date createTime;
// getter setter ...
}
老闆查詢自己當前需要審批的任務,並且將任務和引數設定到一個VacTask物件,用於頁面的展示。
(2)審批請假
public Object passAudit(String userName, VacTask vacTask) {
String taskId = vacTask.getId();
String result = vacTask.getVac().getResult();
Map<String, Object> vars = new HashMap<>();
vars.put("result", result);
vars.put("auditor", userName);
vars.put("auditTime", new Date());
taskService.claim(taskId, userName);
taskService.complete(taskId, vars);
return true;
}
同理,result是審批的結果,也是在完成審批任務時需要傳入的引數;taskId是剛才老闆查詢到的當前需要自己完成的審批任務ID。(如果流程在這裡設定分支,可以通過判斷result的值來跳轉到不同的任務)
3. 查詢記錄
由於已完成的請假在資料庫runtime表中查不到(runtime表只儲存正在進行的流程示例資訊),所以需要在history表中查詢。
(1) 查詢請假記錄
public Object myVacRecord(String userName) {
List<HistoricProcessInstance> hisProInstance = historyService.createHistoricProcessInstanceQuery()
.processDefinitionKey(PROCESS_DEFINE_KEY).startedBy(userName).finished()
.orderByProcessInstanceEndTime().desc().list();
List<Vacation> vacList = new ArrayList<>();
for (HistoricProcessInstance hisInstance : hisProInstance) {
Vacation vacation = new Vacation();
vacation.setApplyUser(hisInstance.getStartUserId());
vacation.setApplyTime(hisInstance.getStartTime());
vacation.setApplyStatus("申請結束");
List<HistoricVariableInstance> varInstanceList = historyService.createHistoricVariableInstanceQuery()
.processInstanceId(hisInstance.getId()).list();
ActivitiUtil.setVars(vacation, varInstanceList);
vacList.add(vacation);
}
return vacList;
}
請假記錄即查出歷史流程例項,再查出關聯的歷史引數,將歷史流程例項和歷史引數設定到Vcation物件(VO物件)中去,即可返回,用來展示。
package com.yawn.util;
import org.activiti.engine.history.HistoricVariableInstance;
import java.lang.reflect.Field;
import java.util.List;
/**
* activiti中使用得到的工具方法
* @author Created by yawn on 2018-01-10 16:32
*/
public class ActivitiUtil {
/**
* 將歷史引數列表設定到實體中去
* @param entity 實體
* @param varInstanceList 歷史引數列表
*/
public static <T> void setVars(T entity, List<HistoricVariableInstance> varInstanceList) {
Class<?> tClass = entity.getClass();
try {
for (HistoricVariableInstance varInstance : varInstanceList) {
Field field = tClass.getDeclaredField(varInstance.getVariableName());
if (field == null) {
continue;
}
field.setAccessible(true);
field.set(entity, varInstance.getValue());
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
此外,以上是查詢歷史流程例項和歷史引數後,設定VO物件的通用方法:可以根據引數列表中的引數,將與VO物件屬性同名的引數設定到VO物件中去。
4. 前端展示和操作
(1)審批列表和審批操作示例
<div ng-controller="myAudit">
<h2 ng-init="myAudit()">待我稽核的請假</h2>
<table border="0">
<tr>
<td>任務名稱</td>
<td>任務時間</td>
<td>申請人</td>
<td>申請時間</td>
<td>天數</td>
<td>事由</td>
<td>操作</td>
</tr>
<tr ng-repeat="vacTask in vacTaskList">
<td>{{vacTask.name}}</td>
<td>{{vacTask.createTime | date:'yyyy-MM-dd HH:mm:ss'}}</td>
<td>{{vacTask.vac.applyUser}}</td>
<td>{{vacTask.vac.applyTime | date:'yyyy-MM-dd HH:mm:ss'}}</td>
<td>{{vacTask.vac.days}}</td>
<td>{{vacTask.vac.reason}}</td>
<td>
<button type="button" ng-click="passAudit(vacTask.id, 1)">稽核通過</button>
<button type="button" ng-click="passAudit(vacTask.id, 0)">稽核拒絕</button>
</td>
</tr>
</table>
</div>
app.controller("myAudit", function ($scope, $http, $window) {
$scope.vacTaskList = [];
$scope.myAudit = function () {
$http.get(
"/myAudit"
).then(function (response) {
$scope.vacTaskList = response.data;
})
};
$scope.passAudit = function (taskId, result) {
$http.post(
"/passAudit",
{
"id": taskId,
"vac": {
"result": result >= 1 ? "稽核通過" : "稽核拒絕"
}
}
).then(function (response) {
if (response.data === true) {
alert("操作成功!");
$window.location.reload();
} else {
alert("操作失敗!");
}
})
}
});
以上是一個springBoot 與 activiti 6.0 整合的示例專案的部分程式碼與說明。
原文以及原始碼請檢視作者部落格: