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

<xs:simpleType name="simple-trigger-misfire-instructionType">
    <xs:annotation>
      <xs:documentation>Simple Trigger Misfire Instructions</xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:pattern value="SmartPolicy" />
      <xs:pattern value="RescheduleNextWithExistingCount" />
      <xs:pattern value="RescheduleNextWithRemainingCount" />
      <xs:pattern value="RescheduleNowWithExistingRepeatCount" />
      <xs:pattern value="RescheduleNowWithRemainingRepeatCount" />
      <xs:pattern value="FireNow" />
      <xs:pattern value="IgnoreMisfirePolicy" />
    </xs:restriction>
  </xs:simpleType>

  <xs:simpleType name="cron-trigger-misfire-instructionType">
    <xs:annotation>
      <xs:documentation>Cron Trigger Misfire Instructions</xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:pattern value="SmartPolicy" />
      <xs:pattern value="DoNothing" />
      <xs:pattern value="FireOnceNow" />
      <xs:pattern value="IgnoreMisfirePolicy" />
    </xs:restriction>
  </xs:simpleType>

  <xs:simpleType name="date-interval-trigger-misfire-instructionType">
    <xs:annotation>
      <xs:documentation>Date Interval Trigger Misfire Instructions</xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:pattern value="SmartPolicy" />
      <xs:pattern value="DoNothing" />
      <xs:pattern value="FireOnceNow" />
      <xs:pattern value="IgnoreMisfirePolicy" />
    </xs:restriction>
  </xs:simpleType>

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的前面，比较严格

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