Activiti基本使用

Activiti 基本使用

idea 安装 Activiti 插件：actiBPM

idea 2020版本及以上已经不支持 actiBPM 插件了，可以用一款新插件替代，参考文档：https://www.bigtspace.com/9603.html

新建 maven 工程，导入依赖

<?xml version="1.0" encoding="UTF-8"?>
<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.yl</groupId>
    <artifactId>activiti-01</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <slf4j.version>1.6.6</slf4j.version>
        <log4j.version>1.2.12</log4j.version>
        <activiti.version>7.0.0.Beta1</activiti.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-engine</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-spring</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <!-- bpmn 模型处理 -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-bpmn-model</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <!-- bpmn 转换 -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-bpmn-converter</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <!-- bpmn json数据转换 -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-json-converter</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <!-- bpmn 布局 -->
        <dependency>
            <groupId>org.activiti</groupId>
            <artifactId>activiti-bpmn-layout</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <!-- activiti 云支持 -->
        <dependency>
            <groupId>org.activiti.cloud</groupId>
            <artifactId>activiti-cloud-services-api</artifactId>
            <version>${activiti.version}</version>
        </dependency>
        <!-- mysql驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.40</version>
        </dependency>
        <!-- mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>
        <!-- 链接池 -->
        <dependency>
            <groupId>commons-dbcp</groupId>
            <artifactId>commons-dbcp</artifactId>
            <version>1.4</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
        <!-- log start -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>${log4j.version}</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
    </dependencies>

</project>

如果报 com.github.jgraph:jgraphx 依赖找不到，则可以将依赖下载到本地即可，没有该依赖也不影响使用；如果不想看到报红可以将该依赖排除：

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-bpmn-layout</artifactId>
    <version>${activiti.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.github.jgraph</groupId>
            <artifactId>jgraphx</artifactId>
        </exclusion>
    </exclusions>
</dependency>

添加 log4j 日志配置

在 resources 下创建 log4j.properties 文件，内容如下：

# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE debug info warn error fatal
log4j.rootCategory=debug, CONSOLE, LOGFILE
# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE
# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %-6r[%15.15t] %-5p %30.30c %x - %m\n
# LOGFILE is set to be a File appender using a PatternLayout.
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File=e:\act\activiti.log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r[%15.15t] %-5p %30.30c %x - %m\n

添加 activiti 配置文件

在 resources 下创建 activiti.cfg.xml 文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                    http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contex
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">

</beans>

在 activiti.cfg.xml 中配置流程引擎和数据源，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                    http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contex
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- processEngine Activiti的流程引擎,默认id对应的值 为processEngineConfiguration-->
    <bean id="processEngineConfiguration"
          class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>
        <property name="jdbcUrl" value="jdbc:mysql:///activiti"/>
        <property name="jdbcUsername" value="root"/>
        <property name="jdbcPassword" value="654321"/>
        <!-- activiti数据库表处理策略:true-如果数据库中已经存在相应的表,则直接使用,如果不存在则新建-->
        <property name="databaseSchemaUpdate" value="true"/>
    </bean>

</beans>

jdbcUrl 三条斜杠代表localhost:3306/，这属于简写，等价于：

<property name="url" value="jdbc:mysql://localhost:3306/activiti"/>

注意：activiti 数据库需要自己手动在 Mysql 建立好

数据源也可以单独配置再引用，如：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                    http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contex
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 这里可以使用 链接池 dbcp-->
    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
        <property name="driverClassName" value="com.mysql.jdbc.Driver" />
        <property name="url" value="jdbc:mysql:///activiti" />
        <property name="username" value="root" />
        <property name="password" value="123456" />
        <property name="maxActive" value="3" />
        <property name="maxIdle" value="1" />
    </bean>

    <bean id="processEngineConfiguration"
          class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <!-- 引用数据源 上面已经设置好了-->
        <property name="dataSource" ref="dataSource" />
        <property name="databaseSchemaUpdate" value="true"/>
    </bean>
</beans>

编写测试类生成 activiti 相关表

import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.junit.Test;

public class createTableTest {

    @Test
    public void createTable(){
        /*
        默认方式获取流程引擎对象ProcessEngine,默认会去读取resource文件夹下的activiti.cfg.xml配置文件
        如果使用默认方式获取ProcessEngine,则activiti配置文件名称必须是activiti.cfg.xml且文件中配置流程引擎对象bean的id必须是processEngineConfiguration
         */
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

        /*
        指定配置文件方式获取流程引擎对象ProcessEngine,该方式activiti配置文件名称可以自定义,但是文件中配置流程引擎对象bean的id必须是processEngineConfiguration
         */
//        ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
//        ProcessEngine processEngine = configuration.buildProcessEngine();

        /*
        自定义方式获取流程引擎对象ProcessEngine,该方式activiti配置文件名称和文件中配置流程引擎对象bean的id都可以自定义
         */
//        ProcessEngineConfiguration configuration=ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String resource, String beanName);
//        ProcessEngine processEngine=configuration.buildProcessEngine();
                
        System.out.println(processEngine);
    }

}

执行测试类，会在配置好的数据库（activiti）中生成相关表

activiti 表介绍

Activiti 的表都以 ACT_ 开头，第二部分是表示表的用途的两个字母标识，用途也和服务的 API 对应

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

表分类	表名	解释
一般数据
	[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]	运行时变量表

Servcie服务接口

Service 服务接口是 Activiti 工作流引擎提供用于进行工作流部署、执行、管理的服务接口，我们使用不同的 Service 接口就可以操作对应的数据表

Service 对象可以通过 ProcessEngine 对象获取

各个 Service 的简单介绍

service名称	service作用
RepositoryService	activiti的资源管理类
RuntimeService	activiti的流程运行管理类
TaskService	activiti的任务管理类
HistoryService	activiti的历史管理类
ManagerService	activiti的引擎管理类

RepositoryService

activiti的资源管理类，提供了管理和控制流程发布包和流程定义的操作，使用工作流建模工具设计的业务流程图需要使用此 service 将流程定义文件的内容部署到计算机，除了部署流程定义以外还可以：查询引擎中的发布包和流程定义；暂停或激活发布包，对应全部和特定流程定义，暂停意味着它们不能再执行任何操作了，激活是对应的反向操作，获得多种资源，像是包含在发布包里的文件，或引擎自动生成的流程图，获得流程定义的pojo版本，可以用来通过java解析流程，而不必通过xml

RuntimeService

Activiti的流程运行管理类，可以从这个服务类中获取很多关于流程执行相关的信息

TaskService

Activiti的任务管理类，可以从这个类中获取任务的信息

HistoryService

Activiti的历史管理类，可以查询历史信息，执行流程时，引擎会保存很多数据（根据配置），比如流程实例启动时间，任务的参与者，完成任务的时间，每个流程实例的执行路径，等等；这个服务主要通过查询功能来获得这些数据

ManagementService

Activiti的引擎管理类，提供了对 Activiti 流程引擎的管理和维护功能，这些功能不在工作流驱动的应用程序中使用，主要用于 Activiti 系统的日常维护

Activiti 基本操作

创建 Activiti 工作流步骤

定义流程，按照BPMN的规范，使用流程定义工具，用流程符号把整个流程描述出来
部署流程，把画好的流程定义文件，加载到数据库中，生成表的数据
启动流程，使用 java 代码来操作数据库表中的内容

案例

在resource 文件夹下新建 bpmn文件夹，bpmn文件夹下新建 evection.bpmn20.xml 文件（创建出差申请流程），内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/processdef">
  <process id="evection" name="evection" isExecutable="true">
    <startEvent id="myEvection" name="出差申请流程"/>
    <userTask id="sid-cc1e9960-75b9-4fe7-b37d-ebf80858c747" name="创建出差申请" activiti:assignee="张三"/>
    <userTask id="sid-04091a7c-56a9-44b5-b79f-00daa338c1ca" name="经理审批" activiti:assignee="经理"/>
    <userTask id="sid-f0101c94-4c54-4f86-b9d2-80288d5e436c" name="总经理审批" activiti:assignee="总经理"/>
    <userTask id="sid-cca4913e-ffa9-4ac3-a20f-fd96b6d6955d" name="财务审批" activiti:assignee="财务"/>
    <endEvent id="sid-697f3706-2f28-4507-bfc0-a3a602e76df5"/>
    <sequenceFlow id="sid-f2e6b6a9-36f0-412b-a279-eecc09b91e40" sourceRef="myEvection" targetRef="sid-cc1e9960-75b9-4fe7-b37d-ebf80858c747"/>
    <sequenceFlow id="sid-f1db32f9-ee81-4f3c-ade8-c1b69619df64" sourceRef="sid-cc1e9960-75b9-4fe7-b37d-ebf80858c747" targetRef="sid-04091a7c-56a9-44b5-b79f-00daa338c1ca"/>
    <sequenceFlow id="sid-30c054f0-aa8c-4d21-b07f-56052de11f67" sourceRef="sid-04091a7c-56a9-44b5-b79f-00daa338c1ca" targetRef="sid-f0101c94-4c54-4f86-b9d2-80288d5e436c"/>
    <sequenceFlow id="sid-28d3be89-5629-4b5a-b5e6-311a1466399a" sourceRef="sid-f0101c94-4c54-4f86-b9d2-80288d5e436c" targetRef="sid-cca4913e-ffa9-4ac3-a20f-fd96b6d6955d"/>
    <sequenceFlow id="sid-b12daf6a-5542-43fc-a1c1-f580875eed0f" sourceRef="sid-cca4913e-ffa9-4ac3-a20f-fd96b6d6955d" targetRef="sid-697f3706-2f28-4507-bfc0-a3a602e76df5"/>
  </process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_evection">
    <bpmndi:BPMNPlane bpmnElement="evection" id="BPMNPlane_evection">
      <bpmndi:BPMNShape id="shape-e111bc08-2466-4cda-80a0-26049de9303c" bpmnElement="myEvection">
        <omgdc:Bounds x="-480.0" y="-245.0" width="30.0" height="30.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape id="shape-f1e0891c-b2aa-4663-91d5-742a6a92cfd9" bpmnElement="sid-cc1e9960-75b9-4fe7-b37d-ebf80858c747">
        <omgdc:Bounds x="-355.0" y="-265.0" width="100.0" height="80.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape id="shape-3c64ce30-ce70-4939-af81-5f6935f4ef3c" bpmnElement="sid-04091a7c-56a9-44b5-b79f-00daa338c1ca">
        <omgdc:Bounds x="-140.0" y="-260.0" width="100.0" height="80.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape id="shape-9b4b14c7-1428-48b7-987e-16784e69f51e" bpmnElement="sid-f0101c94-4c54-4f86-b9d2-80288d5e436c">
        <omgdc:Bounds x="-130.0" y="-90.0" width="100.0" height="80.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape id="shape-3c3ffc38-e444-4ac0-b347-9c110ae5e43c" bpmnElement="sid-cca4913e-ffa9-4ac3-a20f-fd96b6d6955d">
        <omgdc:Bounds x="-130.0" y="70.0" width="100.0" height="80.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape id="shape-c61cf6f4-cf10-4b6d-a3cf-e543af363682" bpmnElement="sid-697f3706-2f28-4507-bfc0-a3a602e76df5">
        <omgdc:Bounds x="75.0" y="115.0" width="30.0" height="30.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNEdge id="edge-88e047f6-8ae5-4b2c-9a33-fe68885b1cea" bpmnElement="sid-f2e6b6a9-36f0-412b-a279-eecc09b91e40">
        <omgdi:waypoint x="-450.0" y="-222.5"/>
        <omgdi:waypoint x="-355.0" y="-225.0"/>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge id="edge-48893a5f-2bec-4c5d-9518-a4be8b3a692a" bpmnElement="sid-f1db32f9-ee81-4f3c-ade8-c1b69619df64">
        <omgdi:waypoint x="-255.0" y="-225.0"/>
        <omgdi:waypoint x="-140.0" y="-220.0"/>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge id="edge-82cf08f3-3746-4cf7-b75c-5d288daa0aad" bpmnElement="sid-30c054f0-aa8c-4d21-b07f-56052de11f67">
        <omgdi:waypoint x="-90.0" y="-180.0"/>
        <omgdi:waypoint x="-80.0" y="-90.0"/>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge id="edge-c53e0e01-0cb3-4e9b-8d3b-cce4ec716b52" bpmnElement="sid-28d3be89-5629-4b5a-b5e6-311a1466399a">
        <omgdi:waypoint x="-80.0" y="-10.0"/>
        <omgdi:waypoint x="-80.0" y="70.0"/>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge id="edge-4d46d591-a52f-4a46-9edd-37ee70c51f5c" bpmnElement="sid-b12daf6a-5542-43fc-a1c1-f580875eed0f">
        <omgdi:waypoint x="-30.0" y="130.0"/>
        <omgdi:waypoint x="75.0" y="130.0"/>
      </bpmndi:BPMNEdge>
    </bpmndi:BPMNPlane>
  </bpmndi:BPMNDiagram>
</definitions>

evection.bpmn20.xml 文件对应流程图如下（将该流程图保存为 png 图片也放在 resource/bpmn 路径下）：

部署出差申请流程到数据库

/**
  * 出差申请流程部署
  */
@Test
public void deploy() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    // 部署出差申请流程
    Deployment deployment = repositoryService.createDeployment()
        // 设置流程文件资源
        .addClasspathResource("bpmn/evection.bpmn20.xml")
        // 设置图片资源
        .addClasspathResource("bpmn/diagram.png")
        // 设置流程名称
        .name("出差申请流程")
        .deploy();
    System.out.println("流程部署id:" + deployment.getId());
    System.out.println("流程部署名称:" + deployment.getName());
}

部署流程涉及到四张表

act_re_deployment：流程部署表，每部署一次就会增加一条记录
act_re_procdef：流程定义表
act_ge_bytearray：流程资源表
act_ge_property：每次操作数据库都会更新该表，不是只有流程部署会动到的表

以上是单个文件方式部署，当有多个流程时对应流程文件也有很多就，如果还是一个一个文件部署就会比较繁琐；对于这种情况，可以通过 zip 方式部署：将 xml 和 png 图片压缩成 evection.zip

@Test
public void deployProcessByZip() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    
    InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream("bpmn/evection.zip");
    ZipInputStream zipInputStream = new ZipInputStream(inputStream);
    
    RepositoryService repositoryService = processEngine.getRepositoryService();
    Deployment deployment = repositoryService.createDeployment()
        .addZipInputStream(zipInputStream).deploy();
    System.out.println("流程部署id:" + deployment.getId());
    System.out.println("流程部署名称:" + deployment.getName());
}

启动流程

/**
  * 启动流程
  */
@Test
public void run(){
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RuntimeService runtimeService = processEngine.getRuntimeService();
    // 根据流程key启动流程(key是act_re_procdef表中流程KEY_对应的值),返回流程实例对象
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("evection");
    System.out.println("流程定义id:" + processInstance.getProcessDefinitionId());
    System.out.println("流程实例id:" + processInstance.getId());
    System.out.println("当前活动Id:" + processInstance.getActivityId());
}

启动流程涉及表：

act_hi_actinst：流程实例执行历史
act_hi_identitylink：流程的参与用户历史信息
act_hi_procinst：流程实例历史信息
act_hi_taskinst：流程任务历史信息
act_ru_execution：流程执行信息
act_ru_identitylink：流程的参与用户信息
act_ru_task：正在执行的任务信息

查询用户待处理任务

/**
  * 查询用户待处理任务
  */
@Test
public void selectWatingTaskList(){
    // 任务负责人
    String assignee = "张三";

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = processEngine.getTaskService();
    // 根据流程key和任务负责人查询任务
    List<Task> list = taskService.createTaskQuery()
        .processDefinitionKey("evection")
        .taskAssignee(assignee)
        .list();

    for (Task task : list) {
        System.out.println("流程实例id:" + task.getProcessInstanceId());
        System.out.println("任务id:" + task.getId());
        System.out.println("任务负责人:" + task.getAssignee());
        System.out.println("任务名称:" + task.getName());
    }
}

处理用户任务

/**
  * 处理用户任务
  */
@Test
public void complete(){
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = processEngine.getTaskService();
    Task task = taskService.createTaskQuery()
        .processDefinitionKey("evection")
        .taskAssignee("张三")
        .singleResult();
    // 完成任务
    taskService.complete(task.getId());
}

查询流程定义相关信息

/**
  * 查询流程定义相关信息
  */
@Test
public void selectProcessDefinition(){
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
    // 获取所有流程定义
    List<ProcessDefinition> definitionList = processDefinitionQuery.processDefinitionKey("evection")
        // 根据流程version排序(act_re_procdef表的VERSION字段)
        .orderByProcessDefinitionVersion()
        // 倒叙
        .desc()
        .list();

    for (ProcessDefinition processDefinition : definitionList) {
        System.out.println("流程定义id="+processDefinition.getId());
        System.out.println("流程定义name="+processDefinition.getName());
        System.out.println("流程定义key="+processDefinition.getKey());
        System.out.println("流程定义Version="+processDefinition.getVersion());
        System.out.println("流程部署ID ="+processDefinition.getDeploymentId());
    }
}

删除流程定义

/**
  * 删除流程定义
  */
@Test
public void deleteProcessDefinition(){
    // 流程部署id(对应act_re_deployment表的ID字段)
    String deploymentId = "1";

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    // 删除流程定义,如果该流程定义已有流程实例启动则删除时出错
    repositoryService.deleteDeployment(deploymentId);

    // true为级联删除流程定义,即使该流程有流程实例启动也可以删除;false为非级联删除方式
    //repositoryService.deleteDeployment(deploymentId, true);
}

使用repositoryService删除流程定义，历史表信息不会被删除

如果该流程定义下没有正在运行的流程，则可以用普通删除；如果该流程定义下存在已经运行的流程，使用普通删除报错，可用级联删除方法将流程及相关记录全部删除，先删除没有完成流程节点，最后就可以完全删除流程定义信息

项目开发中级联删除操作一般只开放给超级管理员使用

posted @ 2020-11-02 19:14 Y-wee 阅读(524) 评论(0) 编辑收藏举报

刷新页面返回顶部