说说 jBPM 工作流的定时器

综合编程 2018-05-16 阅读原文

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,会重复触发事件,直到发生转移。

简书

责编内容by:简书阅读原文】。感谢您的支持!

您可能感兴趣的

Moving your workflow to Linux Since forever, I've been a Windows user with almost zero knowledge of other Oper...
改进GitHub工作流的15个建议 我已经有十多年的软件开发经验,参与过很多开源项目和非开源项目。在这些项目中,我们使用GitHub作为代码协作平台。在这十年中,根据项目的不同,我经历了各种...
ActionView 1.5.0 发布,更好用的问题需求跟踪工具... ActionView 1.5.0 新版本已发布,新版本做了以下内容的更新: 看板增加了Sprint历史查看功能; 点击看板卡片可直接弹出...
Workflow Gallery 上新:一键下载 App Store 首页题图... 新的一年,我们继续发掘好用的 Workflow,这一期 Workflow Gallery 为大家带来了 7 个新动作和 3 个原有动作更新。 如果你有实用、...
Creating a Positive Developer Experience for Conta... This article is featured in the new DZone Guide to Containers: Development...