关于workflow:Flowable-流程实例的挂起暂停与激活

明天来和小伙伴们聊一聊流程的挂起和激活。

这块实际上波及到两局部内容：

1. 流程定义的挂起和激活。
2. 流程实例的挂起和激活。

一个定义好的流程，如果挂起了，那么就无奈据此创立新的流程。

一个流程实例如果挂起了，那么就无奈执行流程中的工作。

小伙伴们留神辨别这两个概念（看了后面几篇文章的小伙伴，应该对于这两个概念不在话下了）。

咱们别离来看。

1. 流程定义的挂起与激活

1.1 查问是否挂起

对于一个定义好的流程，咱们能够通过如下办法来查看这个流程是否挂起：

@Test
void test05() {List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
    for (ProcessDefinition processDefinition : list) {String id = processDefinition.getId();
        boolean suspended = repositoryService.isProcessDefinitionSuspended(id);
        if (suspended) {logger.info("流程定义 {} 已挂起",processDefinition.getName());
        }else{logger.info("流程定义 {} 未挂起",processDefinition.getName());
        }
    }
}

这个查问 SQL 波及到的表是 ACT_RE_PROCDEF，该表中有一个名为 SUSPENSION_STATE_ 的字段，该字段示意这个流程是否挂起。如下图：

1 示意流程没有挂起。

1.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());
}

此时就会抛出如下异样：

这个异样说的很明确了，流程定义被挂起了，无奈开启一个新的流程实例。

1.3 激活

曾经挂起的流程定义，还能够激活，形式如下：

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

激活的原理也很简略，，就是去 ACT_RE_PROCDEF 表中，将 SUSPENSION_STATE_ 字段的值设置为 1，就示意这个流程定义激活了，咱们能够看下流程定义激活时执行的 SQL：

大家留神看操作的表、字段以及对应的参数。

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

第一大节搞懂了，第二大节就容易多了。

2.1 挂起

挂起一个流程实例的形式如下：

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

小伙伴们看到，其实还是方才下面的那个办法，只不过这里多了两个参数：

1. 第二个参数 true 示意是否要挂起这个流程定义对应的所有的流程实例，true 示意挂起。
2. 第三个参数 null 示意流程挂起的具体工夫，如果该参数为 null，则流程会被立马挂起，如果该参数是一个具体的日期，则到期之后流程才会被挂起，然而这个须要 job executor 的反对，对于 job executor，松哥前面再独自发文章和小伙伴们介绍。

执行实现之后，这个流程实例就被挂起了。流程实例被挂起，波及到两个中央：

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

也就是首先 ACT_RU_EXECUTION 表中对应的流程实例会被挂起：

最初一列两个 2 就阐明这两个执行实例被挂起了。

同时，流程实例的 Task 其实也被挂起了，即 ACT_RU_TASK 表中与之对应的工作被挂起了，如下：

能够看到，SUSPENSION_STATE_ 字段的值为 2，示意这 Task 也被挂起了。

咱们来看看挂起流程实例时执行的 SQL：

留神，流程定义自身也被挂起了 。

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

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

则会抛出异样，如下：

这个异样也说的很分明了，无奈实现一个处于挂起状态的 Task。

2.2 激活

处于挂起状态的流程实例，能够通过如下形式激活：

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

一共三个参数：

1. 流程定义的 ID。
2. 是否激活流程定义对应的流程实例。
3. 激活流程实例的工夫，null 示意立马激活，如果是一个具体的工夫，则到期激活，不过和之前的一样，这里也须要 job executor 的反对。

激活就是反向操作，将 ACT_RU_EXECUTION、ACT_RU_TASK 以及 ACT_RE_PROCDEF 表中的 SUSPENSION_STATE_ 字段值再改为 1。对应的 SQL 如下：

好啦，挂起与激活就先聊这么多，下篇文章持续～