Quartz 框架教程（中文版）2.2.x 之第六课 CronTrigger

最新推荐文章于 2018-10-09 20:23:44 发布

1黄鹰

最新推荐文章于 2018-10-09 20:23:44 发布

阅读量2.6k

点赞数 2

分类专栏：应用框架文章标签： quartz 框架教程

应用框架专栏收录该内容

34 篇文章 0 订阅

订阅专栏

原文地址：http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/tutorial-lesson-06

第六课 CronTrigger

CronTrigger比SimpleTrigger更常用，当你需要一个基于日历般概念的作业调度器，而不是像SimpleTrigger那样精确指定间隔时间。

使用SimpleTrigger，你可以这样指定触发时间表例如“每周五的中午”，或是“每周末的上午9:30”，甚至是“一月份每周一、三、五上午9:00到10:00之间每5分钟”。

虽然如此，跟SimpleTrigger一样，CronTrigger也需要指定startTime让调度器生效，指定endTime让调度器终止。

Cron表达式

Cron表达式用于配置CronTrigger实例。Cron表达式实际上是由7个子表达式组成的字符串，描述了时间表的详细信息。这些子表达式用空格隔开，分别代表：

1、秒

2、分

3、小时

4、月份中的天数

5、月

6、星期中的天数

7、年（可选）

一个完整的Cron表达式的字符串例子“0 0 12 ? * WED”，意思是“每周三的上午12:00:00”。

每个了表达式都包含“和”、“或”的两种排列，例如，上一个例子中星期中的天数字段（显示的是“WED”）可以替换为“MON－FRI”，“MON,WED,FRI”，甚至是“MON-WED,SAT”。

通配符（“*”）可用来表示该字段的任意值，因此“*”在上面的例子中的月份字段表示“每个月”，“*”在星期中的天数字段由此明显是表示“一周的任何一天”。

所有的字段都定义了一套可用的值。这些值应该非常明显易懂——例如秒和分的值是从0到59，小时的值是从0到23.月份中的天数是从0到31，但是你需要特别注意这个月实际上有多少天！月份的值指定在0和11之间，或者可以使用字符串JAN，FEB，MAR，APR，MAY，JUN，JUL，AUG，SEP，OCT，NOV和DEC。星期中的天数的值指定在1到7之间（1表示星期天），或是使用字符串SUN，MON，TUE，WED，THU，FRI和SAT。

“/”字符可用来表示增量的值。例如，如果你在分钟字段写“0/15”，这表示“每次从一小时中的第0分钟开始，每隔15分钟触发”，如果你在分钟字段上写“3/20”，这表示“每次从一小时中的第3分钟开始，每隔20分钟触发”——换句话说，这跟在分钟字段上指定“3，23，43”是一样的。注意细微的区别：“/35”不是表示“每隔35分钟”，而是表示“每次从一小时中的第0分钟开始，每隔35分钟触发”，相当于指定“0，35”。

“?”字符允许出现在月份中的天数和星期中的天数字段中。它一般用来指定“不关心的值”。当你需要在这两个字段中的一个指定不确定的值是非常方便的，这个字符不能用在其他的字段中。可以查看下面的例子（或是CronTrigger的JavaDoc文档）获得更详细的说明。

“L”字符允许出现在月份中的天数和星期中的天数字段中。这个字符是“last”的缩写，但是在这两个字段中有不同的含义。例如，“L”字符出现在月份中的天数字段中表示“每月的最后一天”——1月31日，平年的2月28日。如果该字符单独用在星期中的天数字段时，仅仅是表示“7”或是“SAT”。但是在星期中的天数字段中该字符用在其他值的后面，表示“每月的最后一个星期几”——例如“6L”或是“FRIL”都表示“每月的最后一个星期五”。你也可以指定每月最后一天的偏移数，例如“L－3”表示日历月份的最后三天。当你使用“L”字符时，最好不要使用排列值或是带范围的值，否则你会对结果感到意外和难以理解。

“w”字符用来指定给定日期的最近一个工作日（工作日指的是从周一到周五）。例如，如果你在月份中的天数字段的值指定为“15w”，这表示“离每月15号最近的工作日”。

“#”字符用来指定每月的第N个工作日，例如，星期中的天数字段的值为“6#3”或是“FRI#3”表示“每月的第三个星期五”。

下面演示了一些表达式的例子和含义——你可以在org.quartz.CronExpression的JavaDoc找到更多信息。

Cron表达式案例

Cron案例1——仅仅表示每隔5分钟触发一次：

"00/5 * * * ?"

Cron案例2——表示每隔5分钟，在过了10秒后触发一次（例如上午10:00:10，10:05:10等）：

"100/5 * * * ?"

Cron案例3——表示每个周三到周五，在上午10:30，11:30，12:30和13:30分触发：

"030 10-13 ? * WED,FRI"

Cron案例4——表示每月从5号到20号，上午8时到10时之间的每半小时触发，注意这个触发器只在8:00，8:30，9:00和9:30分触发，上午10:00不会触发：

"00/30 8-9 5,20 * ?"

注意有些调度需求因太复杂例如“上午9:00到10:00之间的每5分钟，下午1:00到10:00的每20分钟”，而不能用单一的触发器来表示。这种情况的解决方案是创建两个简单的触发器，将它们注册到调度器中去运行同一个作业任务。

构建CronTriggers

CronTrigger实例对象可以使用TriggerBuilder（针对触发器主要的参数）和CronScheduleBuilder（针对CronTrigger的指定参数）来创建。为了使用这些创建类时满足DSL格式，使用静态导入：

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

创建一个触发器，每天从上午8点到下午5点，每隔2分钟触发一次：

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

创建一个触发器，每天的上午10:42分触发一次：

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();

CronTrigger触发失败指令

CronTrigger有几条指令，用来告知Quartz当触发失败时该如何操作。（在第四课更多关于触发器已经介绍过触发失败的情况）。这些指令在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当中获得解释。JavaDoc文档中CronTrigger的updateAfterMisfire方法解释了动态选择行为的更详细的信息。

当你创建CronTrigger时，可以通过CronSchedulerBuilder指令触发失败指令作为调度器的一部分。

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