---

Table of Contents | ‹ Lesson 5 | Lesson 7 ›

课程 6: CronTrigger

CronTrigger比SimpleTrigger更经常被使用，如果你需要任务触发调度基于日历周期来循环触发，而不是简单的的指定SimpleTrigger的触发时间。

关于CronTrigger, 你可以指定触发调度，例如"每周五的中午"或者"每个工作日的9:30am"，甚至是"一月份的每个星期一、星期三、星期五的9:00am至10:00am每五分钟执行一次"。

即使如此, 像SImpleTirgger一样，CronTrigger也有一个 startTime 指定调度开始的时间, (可选) endTime 则指定调度什么时间会被关闭。

Cron 表达式

Cron-表达式 用于配置CronTrigger实例。Cron-表达式字符串实际上是由7个子表达式组成的，它描述了调度计划的详细细节。这些子表达式之间用空格分割，并表示为：

1. 秒
2. 分
3. 时
4. 月的天
5. 月份
6. 星期几
7. 年 (可选字段)

一个完整的Cron表达式例子例如"0 0 12 ? * WED"-含义是"每星期三12:00:00 pm"执行。

单个子表达式可以包含范围或者列表。例如，星期的天数字段在之间的例子中可以替换为"MON-FRI"，"MON,WD,FRI"，甚至是"MON-WED,SAT"。

通配符可以用来表示"每一个这个字段可能使用的值。因此，前一个示例的"月份"字段表示的含义是"每一个月"。因此在周的日字段上'*'的含义代表着"这一周的每一天"。

所有字段都有一组可以设置的有效值。这些值有那些是显而易见的 - 例如秒和分钟是数字0到59，小时的值是0到23。月的日的值是1-31，但是你需要注意一个月里有多少天！月份可以指定的值是0到11，或者使用字符串JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV and DEC。星期的天可以指定的值是从1到7，或者使用字符串SUN, MON, TUE, WED, THU, FRI 和 SAT。

‘/’字符可以被用来指定增长值。例如，如果你在分钟字段设置'0/15'，它的含义是'在该小时0分钟开始，并且每15分钟执行一次’。 如果你在分钟字段使用‘3/20’，它的含义是‘在该小时3分钟开始，并每20分钟执行一次’ - 或者另一种含义是在分钟字段指定'3,23,43'，注意"/35"的含义不是"每35分钟" - 它的含义是"在该小时0分钟开始，每35分钟执行一次" - 或者另一个种解释是指定"0,35"。

‘?’字符可以用在day-of-month和day-of-week字段上. 它被使用来指定"无指定值"。当你需要再这两个字段之间选择一个字段指定，而不是另一个时，这是十分有用的。看下面的例子说明(CronTrigger JavaDoc)。

‘L’字符可以被用在day-of-month和day-of-week字段. 这个字符是"last"的缩写，但是在这两个字段上有不同的含义。例如，在day-of-month字段上"L"表示含义"月的最后一天"- 一月31天，平年2月28天。如果在day-of-week字段使用，它仅表示"7"或者"SAT"。但是在day-of-week字段使用其他值，它的含义是"月的最后第XXX天"。你也可以指定月的最后一天的偏移量，例如"L-3"含义是日历月的倒数第三天。当使用'L'选项，不能使用指定列表，或者范围值，你将会获得混乱的结果。

‘W’用来指定离给定日期最近的工作日(周一至周五)。例如, 如果在day-of-month字段指定"15W"值，它的含义是"离本月15最近的工作日"。

‘#’是用来指定本月的第XXX个工作日。 例如，在day-of-week字段使用"6#3"或者"FRI#3"含义是"本月的第三个星期五"。

关于更多表达式的例子和他们的含义-你可以通过JavaDoc关于org.quartz.CronExpression来查阅。

Cron表达式例子

CronTrigger 例子 1 - 创建一个每5分钟触发一次的Cron表达式

“0 0/5 * * * ?”

CronTrigger 例子 2 - 创建一个每5分钟在10秒触发的Corn表达式

“10 0/5 * * * ?”

CronTrigger 例子 3 - 创建一个在星期三、星期五10:30，11:30，12:30和13:30触发的Cron表达式。

“0 30 10-13 ? * WED,FRI”

CronTrigger 例子 4 - 创建一个每月第5天、第20天的8点和9点，每半小时触发一次的Cron表达式。注意触发器不会再10:00am触发，只在8:00，8:30，9:00和9:30触发。

“0 0/30 8-9 5,20 * ?”

主要有些表达式太过复杂，无法用一个触发器表达-例如"在9:00和10:00之间每5分钟触发一次，在1:00pm到10:00pm之间每20分钟触发一次"。在这个解决方案中是简单的创建两个触发器，把它们注册到同一个任务中。

Building CronTriggers

CronTrigger实例使用TriggerBuilder构建(trigger的主要属性) 和 CronScheduleBuilder (关于Cron触发器特定的属性). 在DSL-风格使用这些构建，使用静态导入：

import static org.quartz.TriggerBuilder.*;
import static org.quartz.CronScheduleBuilder.*;
import static org.quartz.DateBuilder.*:

构造一个触发器在8am到5pm之间每隔一分钟触发一次：

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 0/2 8-17 * * ?")).forJob("myJob", "group1").build();

构建一个触发器，在10:42 am触发：

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(dailyAtHourAndMinute(10, 42)).forJob(myJobKey).build();

或者 -

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 42 10 * * ?")).forJob(myJobKey).build();

构造一个触发器，在系统默认时区之外的星期三10:42 am触发:

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(weeklyOnDayAndHourAndMinute(DateBuilder.WEDNESDAY, 10, 42)).forJob(myJobKey).inTimeZone(TimeZone.getTimeZone("America/Los_Angeles")).build();

或者 -

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 42 10 ? * WED")).inTimeZone(TimeZone.getTimeZone("America/Los_Angeles")).forJob(myJobKey).build();

CronTrigger 失败介绍

当一个关于CronTrigger的异常发生下面的说明可以通知Qaurtz它可以做什么。(关于本教程中触发器导致错误的情况). 这些指令被定义为CronTrigger本身的常量(包含描述它们行为的JavaDoc). 这些说明包含:

CronTrigger的错误命令常量

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY
MISFIRE_INSTRUCTION_DO_NOTHING
MISFIRE_INSTRUCTION_FIRE_NOW

所有触发器都有Trigger.MISFIRE_INSTRUCTION_SMART_POLICY命令可以被使用，这个命令也是所有触发器类型的默认选项。"智能策略"被CronTrigger触发器解释为MISFIRE_INSTRUCTION_FIRE_NOW. CronTrigger.updateAfterMisfire()方法的JavaDoc解释了它的具体行为。

当构建CronTriggers时，你可以指定错误指令作为构建调度的一部分(例如 CronSchedulerBuilder):

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 0/2 8-17 * * ?")..withMisfireHandlingInstructionFireAndProceed()).forJob("myJob", "group1").build();