Quartz.net misfire实践
1.问题描述
在使用Quartz.net定时运行作业时,存在一种情况:作业错过了某次执行,当作业恢复的时候应该怎么处理?如:job1在3:50的时候应该执行的,但此刻job1处于暂停状态,而到3:55的时候,job1 resume,那么错过的3:50该怎么处理?
对此,Quartz.net使用misfire机制,misfire可以翻译为"错过了触发"。
2.misfire机制
这里以CronTrigger为例,提供了两种可选的值,
DoNothing:不触发立即执行。等待下次Cron触发频率到达时刻开始按照Cron频率依次执行。即如果错过了某次执行,直接忽略。
FireOnceNow:以当前时间为触发频率立刻触发一次执行,然后按照Cron频率依次执行。
而原始的Quartz的还提供了更多的选项:
http://blog.csdn.net/sailorhdx/article/details/7656021
3.如何使用?
3.1 配置文件中
- <!--清除日志文件-->
- <job>
- <name>RemoveLogFileEveryDay</name>
- <group>InnerBusiness</group>
- <description>每天清除两周以前的日志文件</description>
- <job-type>NS.RemoveLogFileEveryDay, NS</job-type>
- <durable>false</durable>
- <recover>true</recover>
- </job>
- <trigger>
- <cron>
- <name>RemoveLogFileEveryDayTrigger</name>
- <group>RemoveLogFileEveryDayTrigger</group>
- <description>每天23:00点执行一次</description>
- <job-name>RemoveLogFileEveryDay</job-name>
- <job-group>InnerBusiness</job-group>
- <misfire-instruction>DoNothing</misfire-instruction>
- <cron-expression>0 0 23 * * ?</cron-expression>
- </cron>
- </trigger>
如上:配置了DoNothing。
3.2 代码中
- ICronTrigger myCronTrigger = scheduler.GetTrigger(triggerKey) as ICronTrigger;
- myCronTrigger.GetTriggerBuilder().WithCronSchedule(cronExpresion, (zw) => { zw.WithMisfireHandlingInstructionDoNothing(); }).Build();
仍然配置了DoNothing
4.艰辛的过程:查找配置方法—— <misfire-instruction>DoNothing</misfire-instruction>
一开始,我就想搜一下,如何配置misfire-instruction的配置,但是怎么都找不到,网上有一堆关于quartz_jobs.xml的配置的例子,可是都没有misfire的配置,因为misfire模式使用的FireOnceNow。
于是去官网的API搜索配置,还是没有找到
然后看到了github,就下载了代码
找到这个文件XMLSchedulingDataProcessor.cs,继续找到QuartzXmlConfiguration20,
XmlSerializer xs = new XmlSerializer(typeof (QuartzXmlConfiguration20));
终于知道是misfire-instruction,而且必须配置在cron-expression的前面,比较严格
继续找到枚举值,直接配置字符串而已~