[译]Quartz.NET 框架 教程(中文版)2.2.x 之第六课 CronTrigger

时间:2022-10-15 07:14:25

第六课 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();