一、Activiti与Spring整合开发
1.1 Activiti与Spring整合的配置
1)、在pom.xml文件引入坐标
<properties>
<slf4j.version>1.6.6</slf4j.version>
<log4j.version>1.2.12</log4j.version>
</properties>
<dependencies>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-engine</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-bpmn-model</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-bpmn-converter</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-json-converter</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-bpmn-layout</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>org.activiti.cloud</groupId>
<artifactId>activiti-cloud-services-api</artifactId>
<version>7.0.0.Beta1</version>
</dependency>
<dependency>
<groupId>aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>1.5.4</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.40</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>5.0.7.RELEASE</version>
</dependency> <!-- log start -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-nop</artifactId>
<version>${slf4j.version}</version>
</dependency> <!-- log end -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<dependency>
<groupId>commons-dbcp</groupId>
<artifactId>commons-dbcp</artifactId>
<version>1.4</version>
</dependency>
</dependencies>
<repositories>
<repository>
<id>alfresco</id>
<name>Activiti Releases</name>
<url>https://artifacts.alfresco.com/nexus/content/repositories/activiti- releases/</url>
<releases>
<enabled>true</enabled>
</releases>
</repository>
</repositories>
在
Activiti
中核心类的是
ProcessEngine
流程引擎,与
Spring
整合就是让
Spring
来管理
ProcessEngine
通过
org.activiti.spring.SpringProcessEngineConfiguration
与
Spring
整合方式来创建
ProcessEngine
对象。
创建
spring
与
activiti
的整合配置文件:
activiti-spring.xml(名称不固定)
2)、创建activiti-spring.xml
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<!-- 数据源 -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/actspring"/>
<property name="username" value="root"/>
<property name="password" value="aaaa"/>
<property name="maxActive" value="3"/>
<property name="maxIdle" value="1"/>
</bean>
<!-- 工作流引擎配置bean -->
<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration">
<!-- 数据源 -->
<property name="dataSource" ref="dataSource"/>
<!-- 使用spring事务管理器 -->
<property name="transactionManager" ref="transactionManager"/>
<!-- 数据库策略 -->
<property name="databaseSchemaUpdate" value="drop-create"/>
</bean>
<!-- 流程引擎 -->
<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
<property name="processEngineConfiguration" ref="processEngineConfiguration"/>
</bean>
<!-- 资源服务service -->
<bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService"/>
<!-- 流程运行service -->
<bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService"/>
<!-- 任务管理service -->
<bean id="taskService" factory-bean="processEngine" factory-method="getTaskService"/>
<!-- 历史管理service -->
<bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService"/>
<!-- 事务管理器 -->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 通知 -->
<tx:advice id="txAdvice" transaction-manager="transactionManager">
<tx:attributes>
<!-- 传播行为 -->
<tx:method name="save*" propagation="REQUIRED"/>
<tx:method name="insert*" propagation="REQUIRED"/>
<tx:method name="delete*" propagation="REQUIRED"/>
<tx:method name="update*" propagation="REQUIRED"/>
<tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
<tx:method name="get*" propagation="SUPPORTS" read-only="true"/>
</tx:attributes>
</tx:advice>
<!-- 切面,根据具体项目修改切点配置
<aop:config proxy-target-class="true">
<aop:advisor advice-ref="txAdvice"
pointcut="execution(*com.itheima.service.impl..(..))"/>
</aop:config>-->
</beans>
databaseSchemaUpdate
的取值内容:
flase
: 默认值。activiti
在启动时,会对比数据库表中保存的版本,如果没有表或者版本不匹配,将抛出异常。(生产环境常用)
true
: activiti会对数据库中所有表进行更新操作。如果表不存在,则自动创建。(开发时常用)
create_drop
: 在activiti
启动时创建表,在关闭时删除表(必须手动关闭引擎,才能删除表)。(单元测试常用)
drop-create
: 在activiti
启动时删除原来的旧表,然后在创建新表(不需要手动关闭引擎)。
1.2 测试Activiti与Spring整合
1)、测试代码
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = "classpath:activiti-spring.xml")
public class actSpringTest {
@Autowired
private RepositoryService repositoryService;
@Test
public void testRep(){
System.out.println(repositoryService);
}
}
2
)、执行流程分析
下面我们一起来分析
Activiti
与
Spring
整合加载的过程。
1
、加载
activiti-spring.xml
配置文件
2
、加载
SpringProcessEngineConfiguration
对象,这个对象它需要依赖注入
dataSource
对象和
transactionManager
对象。
3
、加载
ProcessEngineFactoryBean
工厂来创建
ProcessEngine
对象,而
ProcessEngineFactoryBean
工厂又需要依赖注入processEngineConfiguration对象。
4
、
processEngine
对象来负责创建我们的
Service
对象,从而简化
Activiti
的开发过程。
二、Activiti7与SpringBoot整合开发
Activiti7
发布正式版之后,它与
SpringBoot2.x
已经完全支持整合开发。
2.1 SpringBoot整合Activiti7的配置
为了能够实现
SpringBoot
与
Activiti7
整合开发,首先我们要引入相关的依赖支持。
在工程的
pom.xml
文件中引入相关的依赖,其中
activiti
的依赖是:
activiti-spring-boot-starter
。
具体依赖如下所示:
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.0.RELEASE</version>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter</artifactId>
<version>7.0.0.Beta2</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
通过该
pom.xml
文件所导入的坐标,我们就可以实现
activiti7
与
Springboot
整合。
2.2 SpringBoot的application.yml文件配置
为了能够实现
Activiti7
生成的表放到
Mysql
数据库中,需要在配置文件
application.yml
中添加相关的配置
注意:
activiti7
默认没有开启数据库历史记录,需要手动配置开启
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql:///actspringboot?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT&nullCatalogMeansCurrent=true
username: root
password: 123456
activiti:
#1.flase:默认值。activiti在启动时,对比数据库表中保存的版本,如果没有表或者版本不匹配,将抛出异常
#2.true: activiti会对数据库中所有表进行更新操作。如果表不存在,则自动创建
#3.create_drop: 在activiti启动时创建表,在关闭时删除表(必须手动关闭引擎,才能删除表)
#4.drop-create: 在activiti启动时删除原来的旧表,然后在创建新表(不需要手动关闭引擎)
database-schema-update: true
#activiti7默认不生成历史信息表,开启历史表
db-history-used: true
#记录历史等级 可配置的历史级别有none, activity, audit, full
#none:不保存任何的历史数据,因此,在流程执行过程中,这是最高效的。
#activity:级别高于none,保存流程实例与流程行为,其他数据不保存。
#audit:除activity级别会保存的数据外,还会保存全部的流程任务及其属性。audit为history的默认值。
#full:保存历史数据的最高级别,除了会保存audit级别的数据外,还会保存其他全部流程相关的细节数据,包括一些流程参数等。
history-level: full
2.3 编写启动类
package com.activiti;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class ActApplication {
public static void main(String[] args) {
SpringApplication.run(ActApplication.class,args);
}
}
2.4 添加SpringSecurity安全框架整合配置
因为
Activiti7
与
SpringBoot
整合后,默认情况下,集成了
SpringSecurity
安全框架,这样我们就要去准备
SpringSecurity整合进来的相关用户权限配置信息。
SpringBoot
的依赖包已经将
SpringSecurity
的依赖包也添加进项目中。
2.4.1 添加SecurityUtil类
为了能够快速实现
SpringSecurity
安全框架的配置,所添加的一个组件。
package com.activiti.utils;
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);
}
}
这个类可以从我们下载的
Activiti7
官方提供的
Example
中找到。
2.4.2 添加DemoApplicationConfig类
在
Activiti7
官方下载的
Example
中找到
DemoApplicationConfig
类,它的作用是为了实现
SpringSecurity
框架的用户权限的配置,这样我们就可以在系统中使用用户权限信息。
本次项目中基本是在文件中定义出来的用户信息,当然也可以是数据库中查询的用户权限信息。
后面处理流程时用到的任务负责人,需要添加在这里
package com.activiti.config;
import lombok.extern.slf4j.Slf4j;
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;
@Slf4j
@Configuration
public class DemoApplicationConfig {
/**
* 添加Secutity的用户
* @return
*/
@Bean
public UserDetailsService myUserDetailsService(){
//把用户存储在内存中
InMemoryUserDetailsManager inMemoryUserDetailsManager = new InMemoryUserDetailsManager();
//构造用户的信息
String [][] usersGroupAndRoles = {
{"jack","password","ROLE_ACTIVITI_USER","GROUP_activitiTeam"},
{"rose","password","ROLE_ACTIVITI_USER","GROUP_activitiTeam"},
{"tom","password","ROLE_ACTIVITI_USER","GROUP_activitiTeam"},
{"jerry","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[] users : usersGroupAndRoles) {
// 用户的角色和组
List<String> authStrList = Arrays.asList(Arrays.copyOfRange(users, 2, users.length));
log.info("> Registering new user: {} with the following Authorities[{}]",users[0],authStrList);
inMemoryUserDetailsManager.createUser(new User(users[0],
passwordEncoder().encode(users[1]),
authStrList.stream().map(str -> new SimpleGrantedAuthority(str)).collect(Collectors.toList())));
}
return inMemoryUserDetailsManager;
}
@Bean
public PasswordEncoder passwordEncoder(){
return new BCryptPasswordEncoder();
}
}
2.5 创建Bpmn文件
Activiti7
可以自动部署流程,前提是在
resources
目录下,创建一个新的目录
processes
,用来放置
bpmn
文件。
创建一个简单的
Bpmn
流程文件,并设置任务的用户组
Candidate Groups
。
Candidate Groups
中的内容与上面
DemoApplicationConfiguration
类中出现的用户组名称要保持一致,可以填写:activitiTeam 或者
otherTeam
。
这样填写的好处:当不确定到底由谁来负责当前任务的时候,只要是
Groups
内的用户都可以拾取这个任务
2.6 使用Junit方式测试
package com.activiti.test;
import lombok.extern.slf4j.Slf4j;
import org.activiti.api.process.model.ProcessDefinition;
import org.activiti.api.process.model.ProcessInstance;
import org.activiti.api.process.model.builders.ProcessPayloadBuilder;
import org.activiti.api.process.runtime.ProcessRuntime;
import org.activiti.api.runtime.shared.query.Page;
import org.activiti.api.runtime.shared.query.Pageable;
import org.activiti.api.task.model.Task;
import org.activiti.api.task.model.builders.TaskPayloadBuilder;
import org.activiti.api.task.runtime.TaskRuntime;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
@Slf4j
@RunWith(SpringRunner.class)
@SpringBootTest
public class TestActiviti {
@Autowired
private ProcessRuntime processRuntime;
@Autowired
private TaskRuntime taskRuntime;
@Autowired
private com.activiti.utils.SecurityUtil securityUtil;
/**
* 查看流程定义内容
* Activiti7可以自动部署流程
*/
@Test
public void findProcess(){
securityUtil.logInAs("jack");
// 流程定义的分页对象
Page<ProcessDefinition> definitionPage = processRuntime.processDefinitions(Pageable.of(0, 10));
log.info("可用的流程定义总数:{}",definitionPage.getTotalItems());
for (ProcessDefinition processDefinition : definitionPage.getContent()) {
System.out.println("==============================");
log.info("流程定义内容:{}",processDefinition);
System.out.println("==============================");
}
}
/**
* 启动流程
*/
@Test
public void startProcess(){
// 设置登录用户
securityUtil.logInAs("system");
ProcessInstance processInstance = processRuntime.
start(ProcessPayloadBuilder.
start().
withProcessDefinitionKey("mydemo").
build());
log.info("流程实例的内容,{}",processInstance);
}
/**
* 执行任务
*/
@Test
public void doTask(){
// 设置登录用户
securityUtil.logInAs("jerry");
// 查询任务
Page<Task> taskPage = taskRuntime.tasks(Pageable.of(0, 10));
if(taskPage != null && taskPage.getTotalItems()>0){
for (Task task : taskPage.getContent()) {
// 拾取任务
taskRuntime.claim(TaskPayloadBuilder.
claim().
withTaskId(task.getId()).
build());
log.info("任务内容,{}",task);
// 完成任务
taskRuntime.complete(TaskPayloadBuilder.
complete().
withTaskId(task.getId()).
build());
}
}
}
}