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

第六课 CronTrigger

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

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

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

Cron表达式

       Cron表达式用于配置CronTrigger实例。Cron表达式其实是由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();