涉及到的代码地址(前端代码没有PUSH): https://gitee.com/MaoLG/springboot-flowable-demo
1. 服务端集成
1.1 集成依赖
org.flowable
flowable-spring-boot-starter
6.7.2
1.2 yml配置
spring:
#数据库链接配置
datasource:
url: jdbc:mysql://127.0.0.1:3306/flowable?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=UTF8
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
flowable:
#异步执行
async-executor-activate: true
#自动更新数据库
database-schema-update: true
#校验流程文件，默认校验resources下的processes文件夹里的流程文件
process-definition-location-prefix: classpath*:/processes/
process-definition-location-suffixes: "**.bpmn20.xml, **.bpmn"
1.3 第一次启动创建表
1.4 创建的服务端的表
1.5 主要几张表介绍
- ACT_RU_TASK 每次启动的流程都会再这张表中,表示代办项, 流程结束会删除该流程数据
- ACT_RU_EXECUTION 流程执行过程表, 会存该流程正在执行的过程数据, 流程结束会删除该流程数据
- ACT_RU_VARIABLE 流程变量表, 流程中传的参数都会再该表存储, 流程结束会删除该流程数据
- ACT_HI_PROCINST 历史运行流程, 当流程处理完了, 在ACT_RU_* 表中就不会有数据, 可以在该表中查询历史
- ACT_HI_TASKINST 历史运行的task信息,
- ACT_RE_PROCDEF 流程模板记录,同一个key多次发布version_字段会递增
- ACT_RE_DEPLOYMENT 部署的流程模板, 可以启动流程使用的
1.6 部署一个流程
- controller
package com.example.springbootflowabledemo.controller;
import com.example.springbootflowabledemo.service.FlowableService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
@RestController
@RequestMapping("/flowable-demo")
public class FlowableController {
@Autowired
private FlowableService flowableService;
@PostMapping("/deploy")
public String deploy(MultipartFile file) throws Exception {
flowableService.deployment(file.getName(), file.getInputStream());
return "流程部署成功!";
}
}
- service
package com.example.springbootflowabledemo.service.impl;
import com.example.springbootflowabledemo.service.FlowableService;
import lombok.extern.slf4j.Slf4j;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.repository.Deployment;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.io.InputStream;
@Slf4j
@Service
public class FlowableServiceImpl implements FlowableService {
@Autowired
private RepositoryService repositoryService;
@Transactional(rollbackFor = Exception.class)
@Override
public void deployment(String name, InputStream in) {
Deployment deploy = repositoryService.createDeployment().addInputStream(name + BPMN_FILE_SUFFIX, in).name(name).deploy();
log.info("流程部署id={}", deploy.getId());
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().deploymentId(deploy.getId()).singleResult();
log.info("(启动流程使用)流程processDefinitionId={}", processDefinition.getId());
}
}
1.7 启动一个流程
- req
package com.example.springbootflowabledemo.domian.req;
import lombok.Data;
import java.util.Map;
@Data
public class ActivateReq {
private String procdefId;
private Map variables;
}
- controller
@PostMapping("/activate")
public String activate(@RequestBody ActivateReq req) {
flowableService.activate(req.getProcdefId(), req.getVariables());
return "流程启动成功!";
}
- service
import org.flowable.engine.RuntimeService;
import org.flowable.engine.TaskService;
@Autowired
private RuntimeService runtimeService;
@Autowired
private TaskService taskService;
@Override
public void activate(String procdefId, Map variables) {
ProcessInstance processInstance = runtimeService.startProcessInstanceById(procdefId, variables);
log.info("流程id={}", processInstance.getId());
List tasks = taskService.createTaskQuery().processInstanceId(processInstance.getId()).list();
for (Task task : tasks) {
log.info("流程id={}, 下次执行task={}", processInstance.getId(), task.getId());
}
}
1.8处理节点
- req
package com.example.springbootflowabledemo.domian.req;
import lombok.Data;
import java.util.Map;
@Data
public class CompleteReq {
private String taskId;
private Map variables;
}
- controller
@PostMapping("/complete")
public String complete(@RequestBody CompleteReq req) {
flowableService.complete(req.getTaskId(), req.getVariables());
return "节点处理完成!";
}
- service
@Override
public void complete(String taskId, Map variables) {
taskService.complete(taskId, variables);
}
2. 客户端集成
2.1 集成依赖
org.flowable
flowable-ui-modeler-rest
6.7.2
org.flowable
flowable-ui-modeler-conf
6.7.2
2.2 解决添加依赖报错
- 问题1
Caused by: java.lang.IllegalArgumentException:
flowable.common.app.idm-urlmust be set
at org.springframework.util.Assert.hasText(Assert.java:289) ~[spring-core-5.3.22.jar:5.3.22]
at org.flowable.ui.common.properties.FlowableCommonAppProperties.determineIdmAppUrl(FlowableCommonAppProperties.java:150) ~[flowable-ui-common-6.7.2.jar:6.7.2]
at org.flowable.ui.common.service.idm.RemoteIdmServiceImpl.(RemoteIdmServiceImpl.java:60) ~[flowable-ui-common-6.7.2.jar:6.7.2]
at org.flowable.ui.common.security.FlowableUiSecurityAutoConfiguration$RemoteIdmConfiguration.remoteIdmService(FlowableUiSecurityAutoConfiguration.java:120) ~[flowable-ui-common-6.7.2.jar:6.7.2]
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_181]
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_181]
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_181]
at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_181]
at org.springframework.beans.factory.support.SimpleInstantiationStrategy.instantiate(SimpleInstantiationStrategy.java:154) ~[spring-beans-5.3.22.jar:5.3.22]
... 20 common frames omitted
解决办法
flowable:
#该配置只是防止报错,没有实际意义
common:
app:
idm-admin:
password: test
user: test
#没有实际意义
idm-url: http://localhost:8080/flowable-demo
2.3 集成前端ui
将flowable源码的UI放到自己项目resources目录下, 创建static目录
源码下载地址: https://github.com/flowable/flowable-engine/tree/flowable-6.7.2
将以下路径的代码复制到自己工程
/flowable-6.7.2/modules/flowable-ui/flowable-ui-modeler-frontend/src/main/resources/static/modeler
如图
打开地址, 效果 http://localhost:8080/modeler/#/processes
2.4 如果遇到需要登录情况, 绕过校验
package com.example.springbootflowabledemo.config;
import org.flowable.ui.common.security.SecurityConstants;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.annotation.Order;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
/**
* 绕过flowable的登录验证
*/
@Configuration
public class SecurityConfiguration {
@Configuration(proxyBeanMethods = false)
//Order配置说明
// 这个地方相同会报错
//这个地方如果大于则该配置在FlowableUiSecurityAutoConfiguratio中对应项后加载，不能起到绕过授权作用
//所以这个地方-1让该配置项在FlowableUiSecurityAutoConfiguratio中对应配置项前加载，以跳过授权
@Order(SecurityConstants.FORM_LOGIN_SECURITY_ORDER - 1)
public static class FormLoginWebSecurityConfigurerAdapter extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.headers().frameOptions().disable();
http
//必须要将csrf设置为disable，不然后面发送POST请求时会报403错误
.csrf().disable()
//为了简单起见，简单粗暴方式直接放行modeler下面所有请求
.authorizeRequests().antMatchers("/modeler/**").permitAll();
}
}
}