JeecgBoot集成工作流实战教程

最新推荐文章于 2025-02-27 18:27:46 发布

xrl2012

最新推荐文章于 2025-02-27 18:27:46 发布

阅读量2k

点赞数 26

分类专栏： jeecgflow 文章标签：工作流 jeecgboot activiti

本文链接：https://blog.youkuaiyun.com/xrl2012/article/details/143462385

版权

jeecgflow 专栏收录该内容

37 篇文章

订阅专栏

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);
  }