流程引擎Camunda-高级篇

Mr_行知

已于 2023-07-15 12:30:35 修改

阅读量2.4k

点赞数 24

分类专栏：流程引擎 Camunda 文章标签： java spring boot 开发语言

于 2023-07-14 23:25:26 首次发布

本文链接：https://blog.csdn.net/qq_39085297/article/details/131732793

版权

流程引擎同时被 2 个专栏收录

2 篇文章 1 订阅

订阅专栏

Camunda

2 篇文章 0 订阅

订阅专栏

流程引擎Camunda-高级篇

一、IDEA引入流程设计器

在工作流引擎中流程设计器是一个非常重要的组件，而InterlliJ IDEA是Java程序员用到的最多的编程工具了。前面在基础篇的介绍中我们都在通过Camunda提供的流程设计器绘制好流程图，然后需要单独的拷贝到项目中，要是调整修改不是很方便，这时我们可以在IDEA中和流程设计器绑定起来。这样会更加的灵活。

1.下载Camunda Model

第一步肯定是需要下载Camunda Model 这个流程设计器，我们前面有介绍。就是之前解压好的目录了。
在这里插入图片描述

2.IDEA中配置

我们先进入settings中然后找到tools,继续找到External Tool.
在这里插入图片描述

最终效果
在这里插入图片描述

3.编辑bpmn文件

找到您想打开的bpmn文件, 点击右键, 找到External Tools 运行camunda modler即可进行文件编写.
在这里插入图片描述
搞定~

二、SpringBoot整合Camunda

1.官方案例说明

接下来我们看看怎么在我们的实际项目中来使用Camunda了。方式有多种，首先我们可以参考官网提供的整合案例。
在这里插入图片描述

但是这里有个比较头疼的问题就是Camunda和SpringBoot版本的兼容性问题，虽然官方也给出了兼容版本的对照表。
在这里插入图片描述

但是如果不小心还是会出现各种问题，比如：
在这里插入图片描述
上面就是典型的版本不兼容的问题了。

2.官方Demo

为了能让我们的案例快速搞定，我们可以通过Camunda官方提供的网站来创建我们的案例程序。地址：https://start.camunda.com/
在这里插入图片描述

生成代码后，解压后我们通过idea打开项目，项目结构
在这里插入图片描述
相关的pom.xml中的依赖

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example.workflow</groupId>
  <artifactId>camunda-project-demo</artifactId>
  <version>1.0.0-SNAPSHOT</version>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
  </properties>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>2.6.4</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>

      <dependency>
        <groupId>org.camunda.bpm</groupId>
        <artifactId>camunda-bom</artifactId>
        <version>7.17.0</version>
        <scope>import</scope>
        <type>pom</type>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <dependency>
      <groupId>org.camunda.bpm.springboot</groupId>
      <artifactId>camunda-bpm-spring-boot-starter-rest</artifactId>
    </dependency>

    <dependency>
      <groupId>org.camunda.bpm.springboot</groupId>
      <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
    </dependency>

    <dependency>
      <groupId>org.camunda.bpm</groupId>
      <artifactId>camunda-engine-plugin-spin</artifactId>
    </dependency>

    <dependency>
      <groupId>org.camunda.spin</groupId>
      <artifactId>camunda-spin-dataformat-all</artifactId>
    </dependency>

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

    <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
    </dependency>

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

  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>2.6.4</version>
      </plugin>
    </plugins>
  </build>

</project>

属性文件的配置信息

spring.datasource.url: jdbc:h2:file:./camunda-h2-database

camunda.bpm.admin-user:
  id: demo
  password: demo

然后通过启动类启动程序
在这里插入图片描述
访问服务：http://localhost:8080/

3.MySQL数据库

上面的例子我们数据存储在了H2这个内存型数据库，我们可以切换到MySQL数据库。首先我们需要导入相关的SQL脚本。位置就在我们之前下载的Camunda Web服务中。
在这里插入图片描述
执行创建所有必需的表和默认索引的SQL DDL脚本。上面两个脚本都要执行。

生成的相关表结构比较多，因为本身就是基于Activiti演变而来，所以有Activiti基础的小伙伴会非常轻松了。简单介绍下相关表结构的作用。

ACT_RE ：'RE’表示 repository。这个前缀的表包含了流程定义和流程静态资源（图片，规则，等等）。
ACT_RU：'RU’表示 runtime。这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Flowable只在流程实例执行过程中保存这些数据，在流程结束时就会删除这些记录。这样运行时表可以一直很小速度很快。
ACT_HI：'HI’表示 history。这些表包含历史数据，比如历史流程实例，变量，任务等等。
ACT_GE： GE 表示 general。通用数据，用于不同场景下
ACT_ID: ’ID’表示identity(组织机构)。这些表包含标识的信息，如用户，用户组，等等。

具体的表结构的含义:

表分类	表名	解释
一般数据
	[ACT_GE_BYTEARRAY]	通用的流程定义和流程资源
	[ACT_GE_PROPERTY]	系统相关属性
流程历史记录
	[ACT_HI_ACTINST]	历史的流程实例
	[ACT_HI_ATTACHMENT]	历史的流程附件
	[ACT_HI_COMMENT]	历史的说明性信息
	[ACT_HI_DETAIL]	历史的流程运行中的细节信息
	[ACT_HI_IDENTITYLINK]	历史的流程运行过程中用户关系
	[ACT_HI_PROCINST]	历史的流程实例
	[ACT_HI_TASKINST]	历史的任务实例
	[ACT_HI_VARINST]	历史的流程运行中的变量信息
流程定义表
	[ACT_RE_DEPLOYMENT]	部署单元信息
	[ACT_RE_MODEL]	模型信息
	[ACT_RE_PROCDEF]	已部署的流程定义
运行实例表
	[ACT_RU_EVENT_SUBSCR]	运行时事件
	[ACT_RU_EXECUTION]	运行时流程执行实例
	[ACT_RU_IDENTITYLINK]	运行时用户关系信息，存储任务节点与参与者的相关信息
	[ACT_RU_JOB]	运行时作业
	[ACT_RU_TASK]	运行时任务
	[ACT_RU_VARIABLE]	运行时变量表
用户用户组表
	[ACT_ID_BYTEARRAY]	二进制数据表
	[ACT_ID_GROUP]	用户组信息表
	[ACT_ID_INFO]	用户信息详情表
	[ACT_ID_MEMBERSHIP]	人与组关系表
	[ACT_ID_PRIV]	权限表
	[ACT_ID_PRIV_MAPPING]	用户或组权限关系表
	[ACT_ID_PROPERTY]	属性表
	[ACT_ID_TOKEN]	记录用户的token信息
	[ACT_ID_USER]	用户表

然后我们在SpringBoot项目中导入MySql的依赖，然后修改对应的配置信息

    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
    </dependency>

修改application.yaml。添加数据源的相关信息。

# spring.datasource.url: jdbc:h2:file:./camunda-h2-database

camunda.bpm.admin-user:
  id: demo
  password: demo
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/camunda1?serverTimezone=Asia/Shanghai
    username: root
    password: 123456
camunda:
  bpm:
    database:
      type: mysql
      schema-update: true
    auto-deployment-enabled: false # 自动部署 resources 下的 bpmn文件

然后启动项目，发现数据库中有了相关记录，说明操作成功
在这里插入图片描述

三、Camunda流程审批案例

在这里插入图片描述
每一个服务对应数据库表结构中相关的模块，RepositoryService就是Re，RuntimeService就是Ru，TaskService也是Ru，HistoryService就是Hi，ManagementService是会话管理相关的，暂时没有，IdentityService就是Id。
我们做这个案例，就要得到这个ProcessEngine，进而得到相关的服务，通过这些服务对象，去做相关的处理操作，这些东西我们怎么拿到呢？注意，因为这块我们是整合的一个SpringBoot项目，把相关的配置，配置到属性文件中去了，所以在SpringBoot项目里面，它会通过自动装配，帮助我们去完成ProcessEngine的创建，以及对应的服务对象的注入，它都会帮我们去处理，所以我们在去写这个案例的时候，我们就只需要在容器中去获取这些对象就好了。

1.部署流程

@RestController
@RequestMapping("/flow")
public class FlowController {

    @Autowired
    private RepositoryService repositoryService;

    @GetMapping("/deploy")
    public String deplopy(){
        Deployment deploy = repositoryService.createDeployment()
                .name("部署的第一个流程") // 定义部署文件的名称
                .addClasspathResource("process.bpmn") // 绑定需要部署的流程文件
                .deploy();// 部署流程
        return deploy.getId() + ":" + deploy.getName();
    }
}

启动后访问接口即可
在这里插入图片描述
然后查看表结构
流程部署表

流程定义表

资源表，存流程图文件

2.启动流程

启动流程我们通过单元测试来操作

package com.example.workflow;
import org.camunda.bpm.engine.RepositoryService;
import org.camunda.bpm.engine.RuntimeService;
import org.camunda.bpm.engine.TaskService;
import org.camunda.bpm.engine.runtime.ProcessInstance;
import org.camunda.bpm.engine.task.Task;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.List;

@SpringBootTest(classes = Application.class)
public class ApplicationTest {

    @Autowired
    private RepositoryService repositoryService;

    @Autowired
    private RuntimeService runtimeService;

    @Autowired
    private TaskService taskService;

    /**
     * 启动流程的案例
     */
    @Test
    public void startFlow() {
        //部署流程，参数为：表act_re_procdef的id
        ProcessInstance processInstance = runtimeService.startProcessInstanceById("10447502-22b9-11ee-99ce-d6d853dd353d");
        //部署的流程实例的相关信息
        System.out.println("processInstance.getId() = " + processInstance.getId());
        //流程定义id
        System.out.println("processInstance.getProcessInstanceId() = " + processInstance.getProcessInstanceId());
    }


}

3.查询待办

查询待办也就是查看当前需要审批的任务，通过TaskService来处理

    /**
     * 查询任务，也就是待办
     *
     * 流程定义id：processDefinitionId，我们部署流程的时候，因为部署可以部署两个三个四个五个，所以每个部署行为有一个部署的编号，每一个流程都会产生一个流程定义id。
     * act_ru_task表中的PROC_DEF_ID_
     *
     * 流程实例id：processInstanceId，我们启动流程实例的时候，会产生一个流程实例id。
     * act_ru_task表中的PROC_INST_ID_
     */
    @Test
    public void queryTask() {
        //创建一个任务查询器
        List<Task> list = taskService.createTaskQuery()
//                .processInstanceId("953f8879-22c3-11ee-9e85-d6d853dd353d")
                .taskAssignee("demo")
                .list();
        if (CollectionUtils.isEmpty(list)) {
            return;
        }
        for (Task task : list) {
            System.out.println("task.getId() = " + task.getId());
            System.out.println("task.getAssignee() = " + task.getAssignee());
        }
    }

4.完成任务

    /**
     * 完成任务
     */
    @Test
    public void completeTask() {
        //根据用户找到关联的task
        Task task = taskService.createTaskQuery()
                .processInstanceId("953f8879-22c3-11ee-9e85-d6d853dd353d")
//                .taskAssignee("demo")
                .singleResult();
        if (null == task) {
            return;
        }
        taskService.complete(task.getId());
        System.out.println("任务审批完成...");
    }