第六课 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/15”,这表示“每次从一小时中的第0分钟开始,每隔15分钟触发”,如果你在分钟字段上写“3/20”,这表示“每次从一小时中的第3分钟开始,每隔20分钟触发”——换句话说,这跟在分钟字段上指定“3,23,43”是一样的。注意细微的区别:“/35”不是表示“每隔35分钟”,而是表示“每次从一小时中的第0分钟开始,每隔35分钟触发”,相当于指定“0,35”。
“?”字符允许出现在月份中的天数和星期中的天数字段中。它一般用来指定“不关心的值”。当你需要在这两个字段中的一个指定不确定的值是非常方便的,这个字符不能用在其他的字段中。可以查看下面的例子(或是CronTrigger的)获得更详细的说明。
“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的找到更多信息。
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格式,使用静态导入:
创建一个触发器,每天从上午8点到下午5点,每隔2分钟触发一次:
trigger = TriggerBuilder.Create()
.WithIdentity("trigger3", "group1")
.WithCronSchedule("0 0/2 8-17 * * ?")
.ForJob("myJob", "group1")
.Build();
创建一个触发器,每天的上午10:42分触发一次:
// we use CronScheduleBuilder's static helper methods here
trigger = TriggerBuilder.Create()
.WithIdentity("trigger3", "group1")
.WithSchedule(CronScheduleBuilder.DailyAtHourAndMinute(, ))
.ForJob(myJobKey)
.Build();
或者
trigger = TriggerBuilder.Create()
.WithIdentity("trigger3", "group1")
.WithCronSchedule("0 42 10 * * ?")
.ForJob("myJob", "group1")
.Build();
CronTrigger触发失败指令
CronTrigger有几条指令,用来告知Quartz当触发失败时该如何操作。(在第四课更多关于触发器已经介绍过触发失败的情况)。这些指令在CronTrigger类中设计成常量(包含JavaDoc描述了它们的行为)。指令有:
CronTrigger的触发失败指令常量
•MisfireInstruction.IgnoreMisfirePolicy
•MisfireInstruction.CronTrigger.DoNothing
•MisfireInstruction.CronTrigger.FireOnceNow
所有的触发器都可以使用Trigger.MISFIRE_INSTRUCTION_SMART_POLICY指令,并且这条指令也是所有触发器的默认指令。
“智能策略”指令可以从CronTrigger的MISFIRE_INSTRUCTION_FIRE_NOW当中获得解释。文档中CronTrigger的updateAfterMisfire方法解释了动态选择行为的更详细的信息。
当你创建CronTrigger时,可以通过CronSchedulerBuilder指令触发失败指令作为调度器的一部分。
trigger = TriggerBuilder.Create()
.WithIdentity("trigger3", "group1")
.WithCronSchedule("0 0/2 8-17 * * ?", x => x
.WithMisfireHandlingInstructionFireAndProceed())
.ForJob("myJob", "group1")
.Build();