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

第六课 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分钟触发一次：

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 0/2 8-17 * * ?")
4     .ForJob("myJob", "group1")
5     .Build();

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

1 // we use CronScheduleBuilder's static helper methods here
2 trigger = TriggerBuilder.Create()
3     .WithIdentity("trigger3", "group1")
4     .WithSchedule(CronScheduleBuilder.DailyAtHourAndMinute(10, 42))
5     .ForJob(myJobKey)
6     .Build();

    或者

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 42 10 * * ?")
4     .ForJob("myJob", "group1")
5     .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指令触发失败指令作为调度器的一部分。

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 0/2 8-17 * * ?", x => x
4         .WithMisfireHandlingInstructionFireAndProceed())
5     .ForJob("myJob", "group1")
6     .Build();