JeecgBoot集成工作流实战教程

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: fullcheck-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