springboot，Flowable 流程实例的激活与挂起（二）

一.简介

接上一篇 springboot，Flowable 流程实例的激活与挂起（一）

二.流程实例的挂起与激活

1.流程实例的挂起

挂起一个流程实例的代码如下：

@Test
void test08() {
    List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
    for (ProcessDefinition pd : list) {
        repositoryService.suspendProcessDefinitionById(pd.getId(), true, null);
    }
}

其实还是挂起流程模板（流程定义）的那个方法，只不过这里多了两个参数：

第一个参数：流程模板（流程定义）的 ID
第二个参数 true 表示是否要挂起这个流程定义对应的所有的流程实例，true 表示挂起。
第三个参数 null 表示流程挂起的具体时间，如果该参数为 null，则流程会被立马挂起，如果该参数是一个具体的日期，则到期之后流程才会被挂起，但是这个需要 job executor 的支持。

执行完成之后，这个流程实例就被挂起了。流程实例被挂起，涉及到两个地方：

流程的执行实例被挂起。
流程的 Task 被挂起。

也就是首先 ACT_RU_EXECUTION 表中对应的流程实例会被挂起：
在这里插入图片描述
最后一列两个 2 就说明这两个执行实例被挂起了。

同时，流程实例的 Task 其实也被挂起了，即 ACT_RU_TASK 表中与之对应的任务被挂起了，如下：
在这里插入图片描述
注意，流程定义本身也被挂起了。

对于处于挂起状态的流程实例，是无法继续执行的，如果强行执行，代码如下：

@Test
void test03() {
    List<Task> list = taskService.createTaskQuery().taskAssignee("wangwu").list();
    for (Task task : list) {
        taskService.complete(task.getId());
    }
}

执行后会抛出异常，如下：
在这里插入图片描述
这个异常意思是无法完成一个处于挂起状态的 Task。

2.激活

执行如下方法，可以挂起一个流程模板（流程定义），代码如下：

@Test
void test06() {
    List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
    for (ProcessDefinition pd : list) {
        repositoryService.suspendProcessDefinitionById(pd.getId());
    }
}

挂起的原理其实很简单，就是去 ACT_RE_PROCDEF 表中，将 SUSPENSION_STATE_ 字段的值设置为 2，就表示这个流程定义挂起了，我们可以看下流程定义挂起时执行的 SQL：
在这里插入图片描述
从这个执行的 SQL 中我们可以清晰的看到，操作的表是 ACT_RE_PROCDEF，修改的字段就是 SUSPENSION_STATE_，将该字段的值修改为 2（乐观锁相关的 REV_ 字段不考虑）。

对于一个已经挂起的流程定义，如果我们想据此启动一个流程，如下：

@Test
void test01() {
    identityService.setAuthenticatedUserId("wangwu");
    ProcessInstance pi = runtimeService.startProcessInstanceByKey("leave");
    logger.info("id:{},activityId:{}", pi.getId(), pi.getActivityId());
}

此时就会抛出如下异常：
在这里插入图片描述
这个异常说的很明白了，流程定义被挂起了，无法开启一个新的流程实例。

3.流程实例的激活

处于挂起状态的流程实例，可以通过如下代码激活：

@Test
void test09() {
    List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
    for (ProcessDefinition pd : list) {
        repositoryService.activateProcessDefinitionById(pd.getId(), true, null);
    }
}

其实还是激活流程模板（流程定义）的那个方法，只不过这里多了两个参数：

第一个参数：流程模板（流程定义）的 ID
第二个参数 true 表示是否要激活这个流程定义对应的所有的流程实例，true 表示激活。
第三个参数 null 表示流程激活的具体时间，如果该参数为 null，则流程会被立马激活，如果该参数是一个具体的日期，则到期之后流程才会被激活，但是这个需要 job executor 的支持。

激活就是反向操作，将 ACT_RU_EXECUTION、ACT_RU_TASK 以及 ACT_RE_PROCDEF 表中的 SUSPENSION_STATE_ 字段值再改为 1。对应的 SQL 如下：
在这里插入图片描述