jBPM jPDL 用户开发手册 3.2.3 - 第16章

第16章 商务日历

本章描述了jBPM的商务日历。商务日历知道关于业务小时和用于任务和定时器的到期的计算。

商务日历能够通过在基准日期（base datea）上加或减去一个持续时间（duration to）来计算到期日期。如果基准日期被忽略，那么会使用当前（'current'）日期。

16.1. 到期日期

正像提到的那样，到期日期是由持续时间（duration）和基准日期（base date）。如果这个基准日期被忽略，持续时间是相对于计算到期日期时的那个日期（时间）。格式是：

duedate ::= [<basedate> +/-] <duration>

16.1.1. 持续时间

持续时间被指定用绝对时（absolute）或工作时（business）。让我们看下语法：

A duration is specified in absolute or in business hours. Let's look at the syntax:

duration ::= <quantity> [business] <unit>

里面的 <quantity> 是一个可以使用Double.parseDouble(quantity)来解析的文本。<unit> 是{second, seconds, minute, minutes, hour, hours, day, days, week, weeks, month, months, year, years}中的一个。然后增加一个可选的指示business意味着只有工作时才能被放入持续时间的数量中。如果没有指示business，持续时间将作为一个绝对的时间周期来进行解释。

16.1.2. 基准日期

持续时间（duration）被指定绝对（absolute）时或工作（business）时。让我们看下语法：

basedate ::= <EL> +/-

其中的<EL>是任何的JAVA表达式语言表达式，可以解析成一个JAVA Date或Calendar对象。引用其他的对象类型变量，即使一个日期格式的String类型的变量（如'2036-02-12'），也会抛出一个JbpmException异常。

注意：这个基准日期（basedate）支持一个普通定时器、任务上提醒和任务内部定时器的duedate属性。但绝不支持这些元素内部的repeate属性。

16.1.3. 示例

下列是所有可能用法的例子：

<timer name="daysBeforeHoliday" duedate="5 business days">...</timer>   <timer name="pensionDate" duedate="#{dateOfBirth} + 65 years" >...</timer>   <timer name="pensionReminder" duedate="#{dateOfPension} - 1 year" >...</timer>   <timer name="fireWorks" duedate="#{chineseNewYear} repeat="1 year" >...</timer>   <reminder name="hitBoss" duedate="#{payRaiseDay} + 3 days" repeat="1 week" />

16.2. 日历配置

目录org/jbpm/calendar下的jbpm.business.calendar.properties文件指定了哪些是工作时。配置文件可以定制而且修改过的复本能够放置在类路径的根下。

这是在jbpm.business.calendar.properties文件中的一个发货的工作时清单的例子：

hour.format=HH:mm #weekday ::= [<daypart> [& <daypart>]*] #daypart ::= <start-hour>-<to-hour> #start-hour and to-hour must be in the hour.format #dayparts have to be ordered weekday.monday=    9:00-12:00 & 12:30-17:00 weekday.tuesday=   9:00-12:00 & 12:30-17:00 weekday.wednesday= 9:00-12:00 & 12:30-17:00 weekday.thursday=  9:00-12:00 & 12:30-17:00 weekday.friday=    9:00-12:00 & 12:30-17:00 weekday.saturday= weekday.sunday=   day.format=dd/MM/yyyy # holiday syntax: <holiday> # holiday period syntax: <start-day>-<end-day> # below are the belgian official holidays holiday.1=  01/01/2005 # nieuwjaar holiday.2=  27/3/2005  # pasen holiday.3=  28/3/2005  # paasmaandag holiday.4=  1/5/2005   # feest van de arbeid holiday.5=  5/5/2005   # hemelvaart holiday.6=  15/5/2005  # pinksteren holiday.7=  16/5/2005  # pinkstermaandag holiday.8=  21/7/2005  # my birthday holiday.9=  15/8/2005  # moederkesdag holiday.10= 1/11/2005  # allerheiligen holiday.11= 11/11/2005 # wapenstilstand holiday.12= 25/12/2005 # kerstmis   business.day.expressed.in.hours=             8 business.week.expressed.in.hours=           40 business.month.expressed.in.business.days=  21 business.year.expressed.in.business.days=  220