Flowable 定时器的各种玩法

@[toc]
今天我们来聊一聊 Flowable 中的定时器。

1. 流程定义定时激活

在之前松哥给小伙伴们介绍流程定义的时候，流程都是定义好之后立马就激活了，其实在流程定义的这个过程中，我们还可以设置一个激活时间，也就是流程定义好之后，并不会立马激活（不激活就不能据此流程定义创建新流程），而是在延迟某一个固定时间之后，才会激活，代码如下：

@RestController
public class ProcessDeployController {

    @Autowired
    RepositoryService repositoryService;

    @PostMapping("/deploy")
    public RespBean deploy(MultipartFile file,String tenantId) throws IOException {
        System.out.println(new Date());
        DeploymentBuilder deploymentBuilder = repositoryService.createDeployment()
                .category("javaboy的工作流分类")
                .name("javaboy的工作流名称")
                .addInputStream("fff.bpmn", file.getInputStream())
                .tenantId(tenantId)
                .activateProcessDefinitionsOn(new Date(System.currentTimeMillis() + 1000 * 60))
                .key("javaboy的工作流key666");
        Deployment deployment = deploymentBuilder
                .deploy();
        return RespBean.ok("部署成功",deployment.getId());
    }
}

.activateProcessDefinitionsOn(new Date(System.currentTimeMillis() + 1000 * 60)) 表示流程在延迟一分钟之后，才激活。

此时，我们启动项目，然后调用该接口部署一个流程，部署完成之后，如果立马调用流程启动方法去启动流程，就会抛出如下异常：

[外链图片转存中…(img-xSdTE0BE-1668358373729)]

可以看到，这里也说的很明确了，这个流程定义目前是一个挂起的状态，无法启动。

这个时候，我们去查看 ACT_RU_TIMER_JOB 表，就会发现该表中多了一条定时任务执行计划：

[外链图片转存中…(img-d73ZciiZ-1668358373730)]

该表有一个 DUEDATE_ 字段，这个字段描述了这个定时任务执行的具体时间，在到达时间后，定时任务会自动执行，将 ACT_RE_PROCDEF 表中，流程的状态字段 SUSPENSION_STATE_ 由 2 改为 1。

2. 流程实例定时挂起

除了流程定义可以定时挂起外，流程实例也可以定时挂起。方式如下：

@Autowired
RepositoryService repositoryService;
@Test
void test23() {
    repositoryService.suspendProcessDefinitionByKey("UserTaskDemo", true, new Date(System.currentTimeMillis() + 120 * 1000));
}

这个执行完成后，也会在 ACT_RU_TIMER_JOB 表中添加一条定时任务，在两分钟之后，会自动挂起这个流程定义以及与之相对应的流程。实际上就是将对应表中的 SUSPENSION_STATE_ 字段值由 1 改为 2。

3. 定时任务执行过程

前面两个小节，松哥都和大家提到，ACT_RU_TIMER_JOB 表中会保存定时任务信息，时间到了就会自动执行。

但是小伙伴们注意，定时任务每次执行的时候，其实并不是去 ACT_RU_TIMER_JOB 表中查询数据，而是去 ACT_RU_JOB 表中查询数据并执行。

当定时的时间到了后，Flowable 会自动将数据从 ACT_RU_TIMER_JOB 表中移动到 ACT_RU_JOB 表中，然后定时器查询到 ACT_RU_JOB 表中的数据之后，就立马自动执行了。大致上就是这样一个流程。

我给大家手动演示一个。

我现在的流程定义和流程实例都挂起了，我想要在 4 分钟之后，将之全部启动，代码如下：

@Test
void test24() {
    repositoryService.activateProcessDefinitionByKey("UserTaskDemo", true, new Date(System.currentTimeMillis() + 240 * 1000));
}

当这行代码执行之后，4 分钟之后，流程定义和流程实例就全部都启动了。但是我现在忽然就不想等四分钟了，我想立马执行，那么我们可以去 ACT_RU_TIMER_JOB 表中找到这个定时任务的 ID，然后执行如下代码：

@Autowired
ManagementService managementService;
@Test
void test25() {
    managementService.moveTimerToExecutableJob("b7e9501d-5075-11ed-9706-acde48001122");
}

这个代码表示将 ID 为 b7e9501d-5075-11ed-9706-acde48001122 的记录由 ACT_RU_TIMER_JOB 表移动到 ACT_RU_JOB 表中，移动完成后，这个任务就会被立马执行。

当一个定时任务开启了，还能不能取消呢？当然可以！我们将这个定时任务放到私信队列表即可，私信队列表是 ACT_RU_DEADLETTER_JOB，具体操作方式如下：

@Test
void test27() {
    managementService.moveJobToDeadLetterJob("6b95dc62-5081-11ed-a00f-acde48001122");
}

上面这个方法执行的参数是 ACT_RU_TIMER_JOB 表中的任务 ID，执行完成后，ACT_RU_TIMER_JOB 表中对应的记录就会被移动到 ACT_RU_DEADLETTER_JOB 表中，所以定时任务就不会被执行了。

对于已经移动到私信队列的定时任务，也可以再通过如下方法移动回 ACT_RU_JOB 表中被立马执行（即使时间没到也会立马执行），如下：

@Test
void test26() {
    managementService.moveDeadLetterJobToExecutableJob("6b95dc62-5081-11ed-a00f-acde48001122", 10);
}

参数就是任务 ID。

好啦，几个简单的例子和小伙伴们分享了下 Flowable 中定时器的玩法，感兴趣的小伙伴可以去试试啦～