Springboot 3集成最新版activiti 8.6,一次成功,完美避坑

国通快递驿站

已于 2024-08-23 08:05:32 修改

阅读量1k

点赞数 9

文章标签： spring boot 后端 java

于 2024-08-23 07:54:57 首次发布

本文链接：https://blog.csdn.net/zypqqgc/article/details/141442922

版权

笔者基于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版本。

国通快递驿站

关注

9
点赞
踩
19

收藏

觉得还不错? 一键收藏
打赏
0
评论
Springboot 3集成最新版activiti 8.6,一次成功,完美避坑

笔者基于activiti 5.23开发了一个深度定制的流程引擎,由于activiti5官方已经放弃更新了,因此长远来看,activiti5迟早要放弃,笔者经过持续观察和调研.最终决定放弃升级到flowable,而是选择升级到activiti最新版,目前是8.6版本.由于activiti6以后资料较少,为了帮助广大开发者快速投入到activiti最新版本使用,笔者决定将自己升级过程中的一些经验,教训,关键步骤等记录下来写成博客形式分享出来.
复制链接

扫一扫