【二十三】springboot整合activiti7（1）实战演示篇

小z666

发布于 2024-06-21 17:46:12

3500

发布于 2024-06-21 17:46:12

文章被收录于专栏：java

本章接着后面几章会进行一个springboot+activiti7的整合，记录自己的学习过程，由于demo篇幅过长，会分好几章进行描述，等写完后，在文章末尾会附上后面几章的链接，本章主要描述demo的需求以及最终效果的一个演示，具体搭建以及实现在后面几章进行依次描述。

一、Demo描述

场景：假设某某公司现在进行了一个管理上的整顿，如果一个产品经理想要提需求，除了要满足甲方以外，还必须让码农们满意，这时就可以有一个审批过程。如下：

后面就通过整合activiti的方式实现如上的一个审批流程。

实现的效果就是：从产品经理发起流程，后面每个节点都可以通过或者退回，退回就是退回到产品经理步骤。然后实现一个流程记录跟踪和流程图跟踪功能。除了审批通过和退回初始节点外，其他的操作后面空了再慢慢学习。

二、准备工作

1、第一步

准备数据库。

需要activi的表以及自己的业务表，activiti的表在部署时会自动创建，现在先不管，本次demo涉及的业务表有如下几个：

表名	描述
user	用户表
role	角色表
user_role	用户角色关联表
demand	需求表

CREATE TABLE `demand` (
  `id` varchar(100) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT '主键',
  `status` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '流程状态，-1是未启动,0是填写表单，1是组长审批，2是开发经理审批，3是项目经理审批，4是结束',
  `name` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '需求名称',
  `content` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '需求具体内容',
  `salt` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '盐字段',
  `taskid` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '任务id',
  `createuser` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '发起人',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8_bin;

CREATE TABLE `role` (
  `id` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '主键',
  `role` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '角色名称'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8_bin;

CREATE TABLE `user` (
  `id` varchar(255) COLLATE utf8_bin NOT NULL COMMENT '主键',
  `username` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '用户名',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8_bin;

CREATE TABLE `user_role` (
  `id` varchar(255) COLLATE utf8_bin NOT NULL COMMENT '主键',
  `userid` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '用户id',
  `roleid` varchar(255) COLLATE utf8_bin DEFAULT NULL COMMENT '角色id',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8_bin;

2、第二步

idea安装插件，绘制流程图。

绘制activiti可以识别的流程图并实现部署，activiti默认可以部署.bpmn和**.bpmn20.xml结尾的文件。

idea有很多画bpmn图的插件，我选择的是activiti BPMN visualizer。

安装好之后，重启idea，在创建的springboot项目的resources资源目录下右键新建一个如下文件。

创建完成后会生成一个xml文件，在这个文件右键，选择view..........就可以打开流程图了。

在图中通过右键添加进行绘制。

最终根据demo的需求场景绘制了如上流程图。菱形是排他网关，长方形是用户事件。

每个节点以及线上面的具体参数后面再讲，此处先讲一个东西参数最好不要用重名的，不然会出问题。

3、第三步

创建项目、导入所需依赖。

这是我项目的目录结构：

然后导入这个demo所需要的依赖，如下：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <!--    工作流依赖    -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-spring-boot-starter</artifactId>
            <version>7.1.0.M3.1</version>
            <exclusions>
                <exclusion><!-- 排除activiti的mybatis，避免和外面的mybatis-plus冲突 -->
                    <!-- 重点坑，不然启动项目会报错mybatisplus缺少类   -->
                    <artifactId>mybatis</artifactId>
                    <groupId>org.mybatis</groupId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.2</version>
        </dependency>

        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.7.22</version>
        </dependency>

        <!--   数据依赖     -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.11</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <!--流程图依赖-->
        <!--  试了几个版本的，有些版本的会导致图片展示不全，注意  -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-image-generator</artifactId>
            <version>5.20.0</version>
        </dependency>

    </dependencies>

有几个坑需要注意一下，上面有在备注里面标注，比如，mybatisplus和activiti的冲突问题以及之后的预览流程图功能的依赖会导致展示不全的问题等。

4、修改配置文件

server:
  port: 8080

spring:
  datasource:
    username: root
    password: 123456
    #    加上nullCatalogMeansCurrent=true才能自动创建activiti需要的表
    url: jdbc:mysql://localhost:3306/activiti?useUnicode=true&useSSL=false&characterEncoding=utf8&serverTimezone=Asia/Shanghai&nullCatalogMeansCurrent=true

  activiti:
    database-schema-update: true
    check-process-definitions: true
    #  注意，如果activiti后面加上了/，就要求启动的时候process文件夹中需要有流程定义文件
    #  是指定activiti流程描述文件的前缀（路径），启动时，activiti就会去寻找此路径下的流程描述文件，并且自动部署
    process-definition-location-prefix: classpath:/activiti/
    #  suffix 是一个String数组，表示描述文件的默认后缀名，默认**.bpmn和**.bpmn20.xml
    #    process-definition-location-suffixes:
    #      - **.bpmn
    #      - **.bpmn20.xml
    #  Activiti7历史数据无法自动插入，开启下面两个配置
    history-level: audit
    db-history-used: true
#  mapper.xml文件所在路径
mybatis-plus:
  mapper-locations: classpath*:mapper/**/*Mapper.xml
#  configuration:
#    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl #开启sql日志

具体的描述我都有写在注释上面。