springboot+flowable请假详细流程
1. flowable-ui
目前flowable-ui主要用于画流程图,流程图画完之后,再对XML做适当的修改
docker安装使用flowable
docker run -d -p 8080:8080 flowable/all-in-one
进入flowable-ui界面
http://127.0.0.1:8080/flowable-modeler
2. springboot 使用
2.1 准备流程文件
Holiday_Request.bpmn20.xml,将文件放在resource/processes目录下,启动是会自动找流程文件部署
<?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:xsd="http://www.w3.org/2001/XMLSchema" 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="holiday-request" name="Holiday Request" isExecutable="true">
<startEvent id="startEvent" flowable:formFieldValidation="true"></startEvent>
<sequenceFlow id="sequenceFlow-df79157f-2c4c-467c-8f27-50e3e1c65795" sourceRef="startEvent" targetRef="approveTask"></sequenceFlow>
<userTask id="approveTask" name="Approve or reject request" flowable:candidateGroups="dept-managers" flowable:formFieldValidation="true"></userTask>
<sequenceFlow id="sequenceFlow-e262d0a2-be78-462e-a382-58a507462e77" sourceRef="approveTask" targetRef="decision"></sequenceFlow>
<exclusiveGateway id="decision"></exclusiveGateway>
<sequenceFlow id="sequenceFlow-4395dd85-dfe3-41e1-9160-5f47ac0755a7" sourceRef="decision" targetRef="externalSystemCall">
<conditionExpression xsi:type="tFormalExpression"><![CDATA[${approved}]]></conditionExpression>
</sequenceFlow>
<sequenceFlow id="sequenceFlow-17d5b350-554f-40ad-a475-b38196d562d7" sourceRef="decision" targetRef="sendRejectionMail">
<conditionExpression xsi:type="tFormalExpression"><![CDATA[${!approved}]]></conditionExpression>
</sequenceFlow>
<serviceTask id="externalSystemCall" name="Enter holidays in external system" flowable:class="com.hsm.flow.callback.HolidayCallback"></serviceTask>
<sequenceFlow id="sequenceFlow-a0666bbf-eccf-4c2f-8567-6131445fa9b6" sourceRef="externalSystemCall" targetRef="holidayApprovedTask"></sequenceFlow>
<userTask id="holidayApprovedTask" name="Holiday approved" flowable:assignee="managers" flowable:formFieldValidation="true">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sequenceFlow-e7697e72-a60f-4b97-9cde-7af165951805" sourceRef="holidayApprovedTask" targetRef="approveEnd"></sequenceFlow>
<serviceTask id="sendRejectionMail" name="Send out rejection email" flowable:class="com.hsm.flow.callback.SendRejectionMailCallback"></serviceTask>
<sequenceFlow id="sequenceFlow-fbd52a13-630e-452b-9136-5939252f8c9f" sourceRef="sendRejectionMail" targetRef="rejectEnd"></sequenceFlow>
<endEvent id="approveEnd"></endEvent>
<endEvent id="rejectEnd"></endEvent>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_holidayRequest">
<bpmndi:BPMNPlane bpmnElement="holiday-request" id="BPMNPlane_holidayRequest">
<bpmndi:BPMNShape bpmnElement="startEvent" id="BPMNShape_startEvent">
<omgdc:Bounds height="30.0" width="30.0" x="240.0" y="255.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="approveTask" id="BPMNShape_approveTask">
<omgdc:Bounds height="60.0" width="100.0" x="320.0" y="240.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="decision" id="BPMNShape_decision">
<omgdc:Bounds height="40.0" width="40.0" x="470.0" y="250.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="externalSystemCall" id="BPMNShape_externalSystemCall">
<omgdc:Bounds height="60.0" width="100.0" x="560.0" y="160.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="holidayApprovedTask" id="BPMNShape_holidayApprovedTask">
<omgdc:Bounds height="60.0" width="100.0" x="710.0" y="160.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="sendRejectionMail" id="BPMNShape_sendRejectionMail">
<omgdc:Bounds height="60.0" width="100.0" x="560.0" y="320.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="approveEnd" id="BPMNShape_approveEnd">
<omgdc:Bounds height="28.0" width="28.0" x="860.0" y="176.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="rejectEnd" id="BPMNShape_rejectEnd">
<omgdc:Bounds height="28.0" width="28.0" x="745.0" y="335.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-e7697e72-a60f-4b97-9cde-7af165951805" id="BPMNEdge_sequenceFlow-e7697e72-a60f-4b97-9cde-7af165951805">
<omgdi:waypoint x="809.9499999999999" y="190.0"></omgdi:waypoint>
<omgdi:waypoint x="860.0" y="190.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-fbd52a13-630e-452b-9136-5939252f8c9f" id="BPMNEdge_sequenceFlow-fbd52a13-630e-452b-9136-5939252f8c9f">
<omgdi:waypoint x="659.949999999997" y="349.66442953020135"></omgdi:waypoint>
<omgdi:waypoint x="745.0003059524752" y="349.09362216470777"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-e262d0a2-be78-462e-a382-58a507462e77" id="BPMNEdge_sequenceFlow-e262d0a2-be78-462e-a382-58a507462e77">
<omgdi:waypoint x="419.9499999999756" y="270.0"></omgdi:waypoint>
<omgdi:waypoint x="470.0" y="270.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-4395dd85-dfe3-41e1-9160-5f47ac0755a7" id="BPMNEdge_sequenceFlow-4395dd85-dfe3-41e1-9160-5f47ac0755a7">
<omgdi:waypoint x="509.9189252336448" y="270.0"></omgdi:waypoint>
<omgdi:waypoint x="522.0" y="270.0"></omgdi:waypoint>
<omgdi:waypoint x="522.0" y="190.0"></omgdi:waypoint>
<omgdi:waypoint x="560.0" y="190.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-17d5b350-554f-40ad-a475-b38196d562d7" id="BPMNEdge_sequenceFlow-17d5b350-554f-40ad-a475-b38196d562d7">
<omgdi:waypoint x="509.9189252336448" y="270.0"></omgdi:waypoint>
<omgdi:waypoint x="522.0" y="270.0"></omgdi:waypoint>
<omgdi:waypoint x="522.0" y="350.0"></omgdi:waypoint>
<omgdi:waypoint x="559.9999999999769" y="350.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-df79157f-2c4c-467c-8f27-50e3e1c65795" id="BPMNEdge_sequenceFlow-df79157f-2c4c-467c-8f27-50e3e1c65795">
<omgdi:waypoint x="269.9499986183554" y="270.0"></omgdi:waypoint>
<omgdi:waypoint x="319.9999999999394" y="270.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="sequenceFlow-a0666bbf-eccf-4c2f-8567-6131445fa9b6" id="BPMNEdge_sequenceFlow-a0666bbf-eccf-4c2f-8567-6131445fa9b6">
<omgdi:waypoint x="659.9499999999999" y="190.0"></omgdi:waypoint>
<omgdi:waypoint x="710.0" y="190.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>
2.2 准备pom文件
<dependencies>
<!-- knife4j,swagger增强版 -->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>2.0.7</version>
</dependency>
<!-- 工作流 -->
<!-- Flowable spring-boot 版套餐 -->
<dependency>
<groupId>org.flowable</groupId>
<artifactId>flowable-spring-boot-starter</artifactId>
<version>6.6.0</version>
</dependency>
<!--mysql-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.16</version>
<scope>runtime</scope>
</dependency>
</dependencies>
2.3 配置数据源
server:
port: 9099
spring:
application:
name: spring-flowable
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://ip:3306/flowable?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=UTF-8&useSSL=false
username: root
password: 123456
2.4 配置流程引擎文件
ProcessEngineConfig.java
@Configuration
@Slf4j
public class ProcessEngineConfig {
/**
* 初始化流程引擎
* @return
*/
@Primary
@Bean(name = "processEngine")
public ProcessEngine initProcessEngine(DataSource dataSource) {
log.info("=============================ProcessEngineBegin=============================");
// 流程引擎配置
ProcessEngineConfiguration cfg = null;
try {
cfg = new StandaloneProcessEngineConfiguration()
.setDataSource(dataSource)
// 初始化基础表,不需要的可以改为 DB_SCHEMA_UPDATE_FALSE
.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
} catch (Exception e) {
e.printStackTrace();
}
// 初始化流程引擎对象
ProcessEngine processEngine = cfg.buildProcessEngine();
log.info("=============================ProcessEngineEnd=============================");
return processEngine;
}
}
2.5 开始写代码
实体类TaskResp.java
@Data
public class TaskResp {
private String taskId;
private String taskName;
}
控制器 HolidayController.java
@RestController
@Api(tags = "请求流程控制器", value = "请求流程控制器")
@RequestMapping("/holiday")
@Slf4j
public class HolidayController {
@Autowired
private IHolidayService holidayService;
@PostMapping("create")
@ApiOperation(value = "创建请假申请", notes = "创建请假申请")
public boolean createRequest(@RequestParam("userName") String userName,
@RequestParam("reason") String reason,
@RequestParam("days") Integer days){
return holidayService.createRequest(userName,reason,days);
}
@GetMapping("list/task")
@ApiOperation(value = "任务列表查询", notes = "任务列表查询")
public List<TaskResp> listTask(@RequestParam(value = "userGroup",required = false) String userGroup,
@RequestParam(value = "username",required = false) String username,
@RequestParam(value = "taskName",required = false) String taskName,
@RequestParam(value = "businessKey",required = false) String businessKey){
return holidayService.listTask(userGroup,username,taskName,businessKey);
}
@GetMapping("complete/task")
@ApiOperation(value = "审核任务", notes = "审核任务")
public boolean completeTask(@RequestParam(value = "taskId",required = true) String taskId,
@RequestParam(value = "approved",required = true) boolean approved){
return holidayService.completeTask(taskId,approved);
}
}
实现类HolidayService.java
@Service
public class HolidayService implements IHolidayService {
@Autowired
private RepositoryService repositoryService;
@Autowired
private RuntimeService runtimeService;
@Autowired
private TaskService taskService;
private static final String processDefinitionId = "holiday-request";
@Override
public boolean createRequest(String userName, String reason, Integer days) {
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
.processDefinitionId(processDefinitionId)
.singleResult();
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("userName", userName);
variables.put("reason", reason);
variables.put("days", days);
ProcessInstance processInstance =
runtimeService.startProcessInstanceByKey(processDefinitionId, variables);
return true;
}
@Override
public List<TaskResp> listTask(String userGroup, String username, String taskName, String businessKey) {
List<TaskResp> dataList = new ArrayList<>();
TaskQuery taskQuery = taskService.createTaskQuery();
if(StringUtils.isNotEmpty(username)){
taskQuery.taskAssignee(username);
}
if(StringUtils.isNotEmpty(userGroup)){
taskQuery.taskCandidateGroup(userGroup);
}
List<Task> list = taskQuery.list();
for (Task task : list) {
TaskResp taskResp = new TaskResp();
taskResp.setTaskId(task.getId());
taskResp.setTaskName(task.getName());
dataList.add(taskResp);
}
return dataList;
}
@Override
public boolean completeTask(String taskId, boolean approved) {
Map<String, Object> variables = new HashMap<>();
variables.put("approved",approved);
variables.put("var",123);
taskService.complete(taskId,variables);
return true;
}
}
回调类
public class HolidayCallback implements JavaDelegate {
@Override
public void execute(DelegateExecution execution) {
System.out.println("审核通过了,保存假期数据入库");
}
}
public class SendRejectionMailCallback implements JavaDelegate {
@Override
public void execute(DelegateExecution execution) {
System.out.println("拒绝了申请,给申请人发送邮件");
}
}
3. 流程说明
看图说话,这里需要仔细看xml文件和流程扭转了
github地址
https://github.com/Steven-hsm/java-interview
用户手册地址
https://tkjohn.github.io/flowable-userguide/#_getting_started