松哥最近正在录制 TienChin 项目视频~采用 Spring Boot+Vue3 技术栈,里边会涉及到各种好玩的技术,小伙伴们来和松哥一起做一个完成率超 90% 的项目,戳戳戳这里-->TienChin 项目配套视频来啦。
今天来和小伙伴们聊一聊流程的挂起和激活。
这块实际上涉及到两部分内容:
一个定义好的流程,如果挂起了,那么就无法据此创建新的流程。
一个流程实例如果挂起了,那么就无法执行流程中的任务。
小伙伴们注意区分这两个概念(看了前面几篇文章的小伙伴,应该对于这两个概念不在话下了)。
我们分别来看。
对于一个定义好的流程,我们可以通过如下方法来查看这个流程是否挂起:
@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 表示流程没有挂起。
执行如下方法,可以挂起一个流程定义,如下:
@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());
}
此时就会抛出如下异常:
这个异常说的很明白了,流程定义被挂起了,无法开启一个新的流程实例。
已经挂起的流程定义,还可以激活,方式如下:
@Test
void test07() {
List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
for (ProcessDefinition pd : list) {
repositoryService.activateProcessDefinitionById(pd.getId());
}
}
激活的原理也很简单,,就是去 ACT_RE_PROCDEF
表中,将 SUSPENSION_STATE_
字段的值设置为 1,就表示这个流程定义激活了,我们可以看下流程定义激活时执行的 SQL:
大家注意看操作的表、字段以及对应的参数。
第一小节搞懂了,第二小节就容易多了。
挂起一个流程实例的方式如下:
@Test
void test08() {
List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
for (ProcessDefinition pd : list) {
repositoryService.suspendProcessDefinitionById(pd.getId(), true, null);
}
}
小伙伴们看到,其实还是刚才上面的那个方法,只不过这里多了两个参数:
执行完成之后,这个流程实例就被挂起了。流程实例被挂起,涉及到两个地方:
也就是首先 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。
处于挂起状态的流程实例,可以通过如下方式激活:
@Test
void test09() {
List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery().list();
for (ProcessDefinition pd : list) {
repositoryService.activateProcessDefinitionById(pd.getId(), true, null);
}
}
一共三个参数:
激活就是反向操作,将 ACT_RU_EXECUTION
、ACT_RU_TASK
以及 ACT_RE_PROCDEF
表中的 SUSPENSION_STATE_
字段值再改为 1。对应的 SQL 如下:
好啦,挂起与激活就先聊这么多,下篇文章继续~
松哥最近正在录制 TienChin 项目视频~采用 Spring Boot+Vue3 技术栈,里边会涉及到各种好玩的技术,小伙伴们来和松哥一起做一个完成率超 90% 的项目,戳戳戳这里-->TienChin 项目配套视频来啦。