Activiti是一个轻量级的工作流程和业务流程管理(BPM)平台,它主要面向业务人员、开发人员和系统管理员。这个平台的核心是一个快速且可靠的Java BPMN 2流程引擎。Activiti是开源的,并且基于Apache许可证进行分发。它可以运行在任何Java应用程序、服务器、集群或云环境中,并且与Spring框架完美集成,以其轻量级和基于简单概念的特点而闻名
Activiti在中国市场的情况
Activiti的工作流引擎功能包括流程定义与建模、流程执行与管理、集成与扩展等。它适用于各行各业的业务流程自动化,包括消费品行业、制造业、电信服务业、金融服务业、物流服务业、政府事业机构等。Activiti的工作流引擎可用于构建各种类型的工作流,如审批流程、业务流程等,通过定义清晰的流程和任务分配规则,企业可以提高工作效率,减少人为错误,并实现流程的自动化。由于activiti发展比较早,在国内各种新老系统都有广泛应用。
如果您是一名新手,该如何快速将Activiti工作流用于自己的业务开发? 我们推荐使用JeecgFlow,这套技术脚手架将帮您快速提高效率。接下来,本文将通过JeecgBoot如何集成Activiti工作流进行阐述,助力您自己动手实现一些简单的Demo!
环境介绍
项目 | 版本 |
---|---|
JeecgBoot | 3.6.1 |
Activiti | 7.0.0.Beat2 |
jdk | 1.8 |
JeecgBoot新增activiti模块
首先,我们要新建一个模块,命名成:jeecg-module-activiti, 与现有的命名方式保持一致。在这个模块去做activiti工作流相关的业务。
1.在项目中,点击右键,选择module
添加图片注释,不超过 140 字(可选)
2.直接进入创建模块,不要选择任何依赖。
添加图片注释,不超过 140 字(可选)
3.完成模块命令,写入jeecg-module-activiti
添加图片注释,不超过 140 字(可选)
<dependency>
<groupId>org.jeecgframework.boot</groupId>
<artifactId>jeecg-boot-base-core</artifactId>
</dependency>
并在该模块下加入上述依赖。 这个是jeecg的核心模块,也是一个公共模块。
4.在jeecg-boot-module-system的start模块的pom.xml引入新增的activit模块
<dependency>
<groupId>org.jeecgframework.boot</groupId>
<artifactId>jeecg-module-activiti</artifactId>
<version>${jeecgboot.version}</version>
</dependency>
5.swagger配置
在swagger配置新模块的swagger扫描bean.找到Swagger2Config。追加如下Bean配置。
@Bean
public Docket loanApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo()).groupName("会员模块")
.select()
//此包路径下的类,才生成接口文档
.apis(RequestHandlerSelectors.basePackage("org.jeecg.crm"))
//加了ApiOperation注解的类,才生成接口文档
.apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
.paths(PathSelectors.any())
.build()
.securitySchemes(Collections.singletonList(securityScheme()));
//.globalOperationParameters(setHeaderToken());
}
6.mybatis-plus配置
mybatis-plus在application.yml中的配置.
mybatis-plus:
mapper-locations: classpath*:classpath*:org/jeecg/activiti/**/xml/*Mapper.
- mybatis-plus配置类的配置.MybatisPlusSaasConfig配置mapper文件扫描路径
@Configuration
@MapperScan(value={"org.jeecg.modules.**.mapper*","org.jeecg.activiti.**.mapper*"})
public class MybatisPlusSaasConfig {
}
完成以上配置, 你可以往这个模块建表。到这也就完成第一步。模块建立。 接下来说明下如何完善activiti模块的依赖和配置。
Activiti模块的安装和配置
项目父pom.xml中新增activiti的依赖
<dependencyManagement>
<dependencies>
<!--以下是所需的依赖文件-->
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter</artifactId>
<version>7.0.0.Beta2</version>
<exclusions>
<exclusion>
<!-- 重点坑,不排除mybatis的话,在启动项目时会报错mybatisplus缺少类 -->
<artifactId>mybatis</artifactId>
<groupId>org.mybatis</groupId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
</dependencyManagement>
jeecg-module-activit模块的依赖
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter</artifactId>
<exclusions>
<exclusion>
<!-- 重点坑,不排除mybatis的话,在启动项目时会报错mybatisplus缺少类 -->
<artifactId>mybatis</artifactId>
<groupId>org.mybatis</groupId>
</exclusion>
</exclusions>
</dependency>
注意啦!需要将这个模块在jeecg-module-system/jeecg-system-start模块的pom.xml新增,如下
<dependencies>
<!-- SYSTEM 系统管理模块 -->
<dependency>
<groupId>org.jeecgframework.boot</groupId>
<artifactId>jeecg-system-biz</artifactId>
<version>${jeecgboot.version}</version>
</dependency>
<!-- Activiti模块 -->
<dependency>
<groupId>org.jeecgframework.boot</groupId>
<artifactId>jeecg-module-activti</artifactId>
<version>${jeecgboot.version}</version>
</dependency>
<!-- DEMO 示例模块 -->
<dependency>
<groupId>org.jeecgframework.boot</groupId>
<artifactId>jeecg-module-demo</artifactId>
<version>${jeecgboot.version}</version>
</dependency>
<!-- flyway 数据库自动升级 -->
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>
</dependencies>
application.yml配置
spring:
activiti:
#1.flase:默认值。activiti在启动时,对比数据库表中保存的版本,如果没有表或者版本不匹配,将抛出异常
#2.true: activiti会对数据库中所有表进行更新操作。如果表不存在,则自动创建
#3.create_drop: 在activiti启动时创建表,在关闭时删除表(必须手动关闭引擎,才能删除表)
#4.drop-create: 在activiti启动时删除原来的旧表,然后在创建新表(不需要手动关闭引擎)
database-schema-update: true
# 检测历史信息表是否存在,activiti7默认不生成历史信息表,开启历史表
db-history-used: true
# 历史记录存储等级
history-level: full
check-process-definitions: true
mysql配置->nullCatalogMeansCurrent=true
url: jdbc:mysql://rxxx/jeecg-camunda?characterEncoding=UTF-8&useUnicode=true&useSSL=false&tinyInt1isBit=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai&nullCatalogMeansCurrent=true
//需要在尾部追加nullCatalogMeansCurrent=true
//如果不追加, 可能会出现cause: java.sql.SQLSyntaxErrorException:
Table 'jeecg-camunda.act_ge_property' doesn't exist
Activiti7 中自带的 Security 安全框架排除掉(因为我这里使用的是 Shiro 安全框架,Security 就没什么用处了)
@SpringBootApplication(exclude = { DataSourceAutoConfiguration.class, SecurityAutoConfiguration.class,
SecurityAutoConfiguration.class,
ManagementWebSecurityAutoConfiguration.class})
public class OAApplication
{
public static void main(String[] args)
{
SpringApplication.run(OAApplication.class, args);
System.out.println("启动成功~");
}
}
上面排除 Security 安全框架的操作对于 Activiti 7.1.0.M6 这个版本是没用的,
因为这个版本的代码强引用了 SpringSecurity 里的内容,
比如在 Activiti 的 SpringBoot 配置类中,强引用 UserDetailsService,
没有这个就会报错,所以我们还需要把版本降到7.1.0.M4及以下。
代码编写
@ApiOperation(value = "启动流程", notes = "启动流程")
@PostMapping("/start")
public Result<?> start(@RequestBody LeaveReq leaveReq) {
log.info("start.leaveReq:{}" + Thread.currentThread().getId());
LoginUser loginUser = (LoginUser) SecurityUtils.getSubject().getPrincipal();
//启动流程&&并设置启动人
Authentication.setAuthenticatedUserId(loginUser.getUsername());
Map<String, Object> variables = new HashMap<>(4);
variables.put("general", loginUser.getUsername());
variables.put("guide", "诸葛亮");
variables.put("leader", "刘备");
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(leaveReq.getModelKey(), variables);
}
综上就是一个Activiti工作流在JeecgBoot开源项目中集成并且简易运行的案例, 更多详情,请访问JeecgFlow