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的还提供了更多的选项：

 

1 
     
       2     
      
        3       
       
        Simple Trigger Misfire Instructions
        4     
       5     
      
        6       
        7       
        8       
        9       
       10       
       11       
       12       
       13     
      14   
     15 16   
     
      17     
      
       18       
       
        Cron Trigger Misfire Instructions
       19     
      20     
      
       21       
       22       
       23       
       24       
       25     
      26   
     27 28   
     
      29     
      
       30       
       
        Date Interval Trigger Misfire Instructions
       31     
      32     
      
       33       
       34       
       35       
       36       
       37     
      38   
     

 

 

3.如何使用？

 

 

3.1 配置文件中

 

1 
      2 
     
       3   
      
       RemoveLogFileEveryDay
       4   
      
       InnerBusiness
       5   
      
       每天清除两周以前的日志文件
       6   
      
       NS.RemoveLogFileEveryDay, NS
       7   
      
       false
       8   
      
       true
       9 
     10 
     
      11   
      
       12     
       
        RemoveLogFileEveryDayTrigger
       13     
       
        RemoveLogFileEveryDayTrigger
       14     
       
        每天23:00点执行一次
       15     
       
        RemoveLogFileEveryDay
       16     
       
        InnerBusiness
       17     
       
        DoNothing
       18     
       
        0 0 23 * *  
       19   
      20 
     

 

如上：配置了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的前面，比较严格

继续找到枚举值，直接配置字符串而已~