说说 jBPM 工作流的定时器

jBPM 定时器(Timer)实现了以下功能:

  • timer 定义在 transition 元素中,当流程处于 state、task、sub-process 类型活动的等待状态时,会开始计算 timer 的时间,当时间耗尽时,就会触发转移。
  • timer 也可以定义在用户代码活动中,负责事件监听的 on 元素支持 timeout 事件。当事件监听器 on 在监听 timeout 事件时,timer 元素必须是 on 元素的第一个子元素。当流程的执行(Execution)进入这个等待活动时,就会激活定时器。如果此活动的持续等待时间超过定时器指定的时间时(超时),就会触发事件;如果流程的执行在定时器指定的时间之内离开此活动,那么就会取消这个定时器。

timer 元素的属性:

属性 类型 默认值 是否必需 描述
duedate 持续时间表达式 必需 指定多长时间以后触发事件。如:15 分钟、2 天等
repeat 持续时间表达式 可选 第一个触发事件后,每隔多长时间再触发事件,这是一个持续的过程。

1 持续时间表达式

持续时间表达式语法如下:

quantity [business]{
  second | seconds | minute | minutes | hour | hours | day | days | week | weeks | month | months | year | years
}
关键字 是否可选 说明
quantity 正整数,描述时间的值。
business 如果存在,则表示按照工作日历来计算时间;如果没有,则按照正常的公历来计算时间。工作日历会按照预先配置的规则,计算时会去除节假日与休息的时间,只考虑工作时间。

配好以上关键字之后,加上需要的时间单位即可。

2 工作日历

系统默认的工作日历配置文件是 jbpm.businesscalendar.cfg.xml,它存在 jbpm4.jar 的根目录下,内容为:





  
  
    
      
      
      
      
      
      
    

  
    


上面配置的工作时间为:周一到周五 9:00-12:00 与 12:30-17:00。01/07/2008 - 31/08/2008 为节假日时间。

工作日历的默认实现类是 BusinessCalendarImpl。

也可以通过实现 org.jbpm.pvm.internal.cal.BusinessCalendar 类来自定义的工作日历,需要实现以下两个方法:

方法 说明
Date add(Date date, String duration) 计算从一个时间点,经过 duration 后,到达的时间点。
Date subtract(Date date, String duration) 计算从一个时间点,减去 duration 后,到达的时间点。这个方法不支持 business 模式。

字符串 duration 通过 new Duration(duration) 来构造出 Duration 对象,它就是持续时间表达式的对象。

在 jbpm.cfg.xml 中配置自定义的工作日历:


    


3 定时转移

流程定义:

jPDL:




   
      
   
   
      
      
      
      
   
   
   

这里假设如果业务员在 15 分钟之内没有进行处理,那么将会发生超时转移,流程将流向 【处理(业务经理)】的活动节点。

单元测试:

//发起流程实例
Execution processInstance = executionService.startProcessInstanceByKey("TimerTransition");

//在 job 中会生成一条【定时器】信息
Job job = managementService.createJobQuery().timers().processInstanceId(processInstance
        .getId()).uniqueResult();


//触发定时器(模拟)
managementService.executeJob(job.getId());

//断言流程进入【处理(业务经理)】活动
processInstance = executionService.findExecutionById(processInstance.getId());

assertEquals("处理(业务经理)", ((ExecutionImpl) processInstance).getActivityName());

4 定时事件

jPDL:




   
      
   
   
      
         
         
      
      
   
   

timer 元素是 timeout 事件的必需元素,这里表示如果在【等待】活动上停留了 15 分钟,那么就会触发 timeout 事件。

自定义 timeout 事件:

public class OvertimeEvent implements EventListener {
    @Override
    public void notify(EventListenerExecution execution) throws Exception {
            //设置流程变量,来表示触发了该事件
            execution.setVariable("OvertimeEvent",Boolean.TRUE);
    }
}

单元测试:

//发起流程实例
Execution processInstance = executionService.startProcessInstanceByKey("TimerEvent");

//在 job 中会生成一条【定时器】信息
Job job = managementService.createJobQuery().timers().processInstanceId(processInstance
        .getId()).uniqueResult();


//触发定时器(模拟)
managementService.executeJob(job.getId());

//断言流程进入【等待】活动(因为我们在事件监听器中并没有发出执行信号)
processInstance = executionService.findExecutionById(processInstance.getId());
Set expectedActivityNames = new HashSet<>();
expectedActivityNames.add("等待");
assertEquals(expectedActivityNames, processInstance.findActiveActivityNames());

//断言事件被触发
assertEquals(Boolean.TRUE, executionService.getVariable(processInstance.getId(), "OvertimeEvent"));

assertEquals("等待", ((ExecutionImpl) processInstance).getActivityName());

如果【等待】活动在 15 分钟之内被完成,那么就会取消自定义的 timeout 事件,相关的 Job 记录也会被删除。

5 工作日历上的定时转移

这个定时转移与我们第 3 节所说的定时转移类似,只不过在配置持续时间表达式时,加入了 business 关键字:


  ...
   
      
      
      
    ...
   
...

这里表示如果当前活动停留了超过 15 个 “工作” 小时,那么就会发生超时转移。工作日历中可以配置每天的工作时间段。

6 定时重复

利用 timer 的 repeat 属性,可以不断地触发事件。


 ...
   
      
         
         
      
      
   
   ...

这里的定义表示:事件被触发后,每隔 15 s,会重复触发事件,直到发生转移。

你可能感兴趣的:(说说 jBPM 工作流的定时器)