笔者基于activiti 5.23开发了一个深度定制的流程引擎AntFlow,由于activiti5官方已经放弃更新了,因此长远来看,activiti5迟早要放弃,升级到新版本是尽早都要做的。而升级就面临着选择(activiti和flowable分家)笔者经过持续观察和调研.最终决定放弃升级到flowable,而是选择升级到activiti最新版,目前是8.6版本.由于activiti6以后资料较少,为了帮助广大开发者快速投入到activiti最新版本使用,笔者决定将自己升级过程中的一些经验,教训,关键步骤等记录下来写成博客形式分享出来.
activiti专业性强,学习曲线较为陡峭,入门写demo容易深入难,后期维护也比较难.为了解决这些难题,笔者基于activiti开发了一个深度定制的,可快速上手的,适合中国式办公场景的流程引擎AntFlow。详细介绍可以打开链接 github地址 gitee地址 前端设计器地址
关于activiti8的介绍可以看我的另一篇文章
Activiti8 面向云原生的activiti版本介绍
下面开始正文,介绍如何将activiti 8.6集成到spring 3中。正文中加粗的部分需要特别关注,如果不注意可能最终和笔者执行的结果不一样。还有就是看的时候最好不要跳跃,本文已经力求减少内容,快速将核心部分展示出来。如果你的项目是一个全新项目,则可以跳过所有,直接复制maven pom文件即可
第一步:创建springboot项目
这一步不再详细介绍,如果使用的是idea专业版,可以直接在idea中通过集成的脚手架创建。我使用的是idea社区版,没有集成springboot项目创建脚本架功能。我使用是spring boot官网脚手架,需要注意的是,activiti8以后只支持java17以上版本,而activiti 8.6 只支持java 21以上版本并且是强制检测的。如果想体验activiti 8.6,应确保你的电脑上安装的jdk21。
另外有一点需要注意的是,截至写本文,springboot最新版本是3.4,但是activiti8.6并不能支持这个版本。(笔者集成3.4的时候出现了错误,尝试解决最终没有解决掉,最后下载下来源码看官方使用的是spring boot 3.3,因此笔者最终选择的是springboot 3.3.2,当然你也可以折腾折腾,可能最后问题就解决了,本文题目是一次成功,目的是避开各种坑,快速将二者集成。
使用springboot 3.3,使用springboot 3.3,使用springboot 3.3重要的事情说三遍
第二步,添加指定仓库
由于activiti7以后(具体哪个版本不清楚了),官方不再将构建制品发布到maven中央仓库了,而是发布在了alfresco仓库,这就需要我们仓库才能正确下载依赖.在pom中添加repositories标签,然后再添加repository标签。如果repositories已经有了,切不要再添加,而是将repository标签和里面的内容复制进去。最终效果如下
<repositories>
<repository>
<id>activiti-releases</id>
<url>https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases</url>
</repository>
第三步,添加依赖管理
activiti本身是一个庞大的系统,存在着众多依赖。虽然这一步不是必须的,但是强烈建议添加上。如果仅仅是跑个demo可能没什么问题,如果后面依赖越来越多了,就可能出现冲突,这时候可能就会花费更多时间来解决
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-dependencies</artifactId>
<version>8.6.0</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
第四步,添加activiti 8.6
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter</artifactId>
<version>8.6.0</version>
</dependency>
需要注意的是activiti必须依赖数据库,如果是简单的demo不想配置数据库,可以使用h2,activiti也是支持的。但是如果想要在生产中使用,h2肯定是不行的,我们这里配置一个生产可用的。
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
第五步添加其它依赖
比如说生产中一般是spring boot web项目,我们往往还使用lombok插件,这时候自己添加即可。
完整pom
下面贴上完整maven pom
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.3.2</version>
<relativePath/>
</parent>
<groupId>org.openoa</groupId>
<artifactId>antflow-future</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>antflow-future</name>
<description>AntFlow next version with activiti 8</description>
<properties>
<java.version>21</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter</artifactId>
<version>8.6.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<repositories>
<repository>
<id>activiti-releases</id>
<url>https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases</url>
</repository>
</repositories>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-dependencies</artifactId>
<version>8.6.0</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
</project>
mysql数据库配置
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://124.222.106.239:3306/activiti8?nullCatalogMeansCurrent=true
username: root(您的账号)
password: 123456(替换成您的密码)
activiti:
database-schema-update: true
db-history-used: true
history-level: full
check-process-definitions: true
需要注意的是,数据库要提前创建好,名字可以是任意,不是必须叫activiti8
配置spring security
为了能够让大家快速启动项目体验,这里就不真正按生产环境来配置了。而是复制了官方demo的内容,后面再开章节介绍如何配置spring security连接自己的数据库获取用户信息
activiti7以后深度集成了spring security,网上很多方法都不是很靠谱。其实没有必要把它去除掉,你的项目可以完全不使用springsecurity,只在activiti相关的业务里面使用就行了。后面会开章节讲解如何跳过spring security认证。(后端代码你不配置使用它的权限验证自然也不会用到,前端请求路由设置全部跳过,让自己已有系统的权限管理框架来接管)
添加配置
package org.openoa.antflow_future.config;
import org.activiti.engine.impl.util.ProcessDefinitionUtil;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.core.authority.SimpleGrantedAuthority;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.provisioning.InMemoryUserDetailsManager;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
@Configuration
public class AntFlowSecurityConfiguration {
private Logger logger = LoggerFactory.getLogger(AntFlowSecurityConfiguration.class);
@Bean
public UserDetailsService myUserDetailsService() {
InMemoryUserDetailsManager inMemoryUserDetailsManager = new InMemoryUserDetailsManager();
//这里添加用户,后面处理流程时用到的任务负责人,需要添加在这里
String[][] usersGroupsAndRoles = {
{"jack", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},
{"rose", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},
{"tom", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},
{"other", "password", "ROLE_ACTIVITI_USER", "GROUP_otherTeam"},
{"system", "password", "ROLE_ACTIVITI_USER"},
{"admin", "password", "ROLE_ACTIVITI_ADMIN"},
};
for (String[] user : usersGroupsAndRoles) {
List<String> authoritiesStrings = Arrays.asList(Arrays.copyOfRange(user, 2, user.length));
logger.info("> Registering new user: " + user[0] + " with the following Authorities[" + authoritiesStrings + "]");
inMemoryUserDetailsManager.createUser(new User(user[0], passwordEncoder().encode(user[1]),
authoritiesStrings.stream().map(s -> new SimpleGrantedAuthority(s)).collect(Collectors.toList())));
}
return inMemoryUserDetailsManager;
}
@Bean
public PasswordEncoder passwordEncoder() {
return new BCryptPasswordEncoder();
}
}
添加工具类
package org.openoa.antflow_future.util;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.security.core.Authentication;
import org.springframework.security.core.GrantedAuthority;
import org.springframework.security.core.context.SecurityContextHolder;
import org.springframework.security.core.context.SecurityContextImpl;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.stereotype.Component;
import java.util.Collection;
@Component
public class SecurityUtil {
private Logger logger = LoggerFactory.getLogger(SecurityUtil.class);
@Autowired
@Qualifier("myUserDetailsService")
private UserDetailsService userDetailsService;
public void logInAs(String username) {
UserDetails user = userDetailsService.loadUserByUsername(username);
if (user == null) {
throw new IllegalStateException("User " + username + " doesn't exist, please provide a valid user");
}
logger.info("> Logged in as: " + username);
SecurityContextHolder.setContext(
new SecurityContextImpl(
new Authentication() {
@Override
public Collection<? extends GrantedAuthority> getAuthorities() {
return user.getAuthorities();
}
@Override
public Object getCredentials() {
return user.getPassword();
}
@Override
public Object getDetails() {
return user;
}
@Override
public Object getPrincipal() {
return user;
}
@Override
public boolean isAuthenticated() {
return true;
}
@Override
public void setAuthenticated(boolean isAuthenticated) throws IllegalArgumentException { }
@Override
public String getName() {
return user.getUsername();
}
}));
org.activiti.engine.impl.identity.Authentication.setAuthenticatedUserId(username);
}
}
启动项目
这时候如果你是按照上面步骤配置的,项目应该是能正常跑起来了
注意点
- java版本需要是java21,并在idea里正确配置项目的jdk版本
- springboot 版本为3.3.x
- 如果您的电脑上装有多个jdk版本,默认的不是java21.项目打包的时候使用idea maven工具里的package,而不是能使用命令行的mvn package,命令行会使用你java home配置的jdk版本。