这一篇将介绍Quartz.NET的哑火策略(Misfire),直接上图:
WithSimpleSchedule的哑火策略 |
WithMisfireHandlingInstructionFireNow |
不追赶哑火,如果有触发哑火,立即执行,更新下次执行时间 |
|
WithMisfireHandlingInstructionIgnoreMisfires |
错过的立即追赶,下次执行时间不变 |
||
WithMisfireHandlingInstructionNext |
WithRemainingCount |
不追赶哑火,正常执行,由于是正常执行下次执行时间不变了(执行次数 = 预计执行次数 - 错过的次数) |
|
WithExistingCount |
不追赶哑火,正常执行,由于是正常执行下次执行时间不变了(执行次数不变) |
||
WithMisfireHandlingInstructionNow |
WithRemainingCount |
立即执行,但不追赶哑火的,更新下次执行时间(执行次数 = 预计执行次数 - 错过的次数) |
|
WithExistingCount |
立即执行,但不追赶哑火的,更新下次执行时间(执行次数不变) |
||
WithCronSchedule的哑火策略 |
WithMisfireHandlingInstructionFireAndProceed |
哑火的任务合并到一次执行,下次正常执行 |
|
WithMisfireHandlingInstructionIgnoreMisfires |
追赶执行哑火的任务,下次正常执行 |
||
WithMisfireHandlingInstructionDoNothing |
什么都不做,下次正常执行 |
具体的例子如下:
任务类MyJob:
public class MyJob : IJob
{
public void Execute(IJobExecutionContext context)
{
Console.WriteLine("本地执行时间:{0},下次执行时间:{1}",
context.ScheduledFireTimeUtc.Value.ToOffset(TimeSpan.FromHours(8)).ToString("yyyy-MM-dd HH:mm:ss"),
context.NextFireTimeUtc.Value.ToOffset(TimeSpan.FromHours(8)).ToString("yyyy-MM-dd HH:mm:ss")
);
}
}
1. WithMisfireHandlingInstructionFireNow(不追赶哑火,如果有触发哑火,立即执行,更新下次执行时间)
var scheduler = StdSchedulerFactory.GetDefaultScheduler();
scheduler.Start();
//将键值对传给定时器
var job = JobBuilder.Create()
.Build();
var trigger = TriggerBuilder.Create()
.StartAt(DateBuilder.DateOf(7,0,0))
.WithSimpleSchedule(m =>
m.WithIntervalInHours(1)
.WithRepeatCount(100)
//如果有触发哑火,立即执行,如果之前定义的是12:00触发,调度时间变成了现在的时间
.WithMisfireHandlingInstructionFireNow()
).Build();
scheduler.ScheduleJob(job, trigger);
执行结果如下:
2. WithMisfireHandlingInstructionIgnoreMisfires(错过的立即追赶,下次执行时间不变)
var scheduler = StdSchedulerFactory.GetDefaultScheduler();
scheduler.Start();
//将键值对传给定时器
var job = JobBuilder.Create()
.UsingJobData("count", 0)
.Build();
var trigger = TriggerBuilder.Create()
.StartAt(DateBuilder.DateOf(7, 0, 0))
.WithSimpleSchedule(m =>
m.WithIntervalInHours(1)
.WithRepeatCount(100)
//错过的立即追赶,然后正常调度
.WithMisfireHandlingInstructionIgnoreMisfires()
).Build();
scheduler.ScheduleJob(job, trigger);
执行结果如下
3. WithMisfireHandlingInstructionNext(不追赶哑火,正常执行,由于是正常执行下次执行时间不变了)
var scheduler = StdSchedulerFactory.GetDefaultScheduler();
scheduler.Start();
//将键值对传给定时器
var job = JobBuilder.Create()
.Build();
var trigger = TriggerBuilder.Create()
.StartAt(DateBuilder.DateOf(7, 0, 0))
.WithSimpleSchedule(m =>
m.WithIntervalInHours(1)
.WithRepeatCount(100)
//正常调度,执行次数 = 预计执行次数 - 错过的次数
//.WithMisfireHandlingInstructionNextWithRemainingCount()
//正常调度,执行次数不变
.WithMisfireHandlingInstructionNextWithExistingCount()
).Build();
scheduler.ScheduleJob(job, trigger);
执行结果如下:
4. WithMisfireHandlingInstructionNow (立即执行,但不追赶哑火的,更新下次执行时间)
var scheduler = StdSchedulerFactory.GetDefaultScheduler();
scheduler.Start();
//将键值对传给定时器
var job = JobBuilder.Create()
.Build();
var trigger = TriggerBuilder.Create()
.StartAt(DateBuilder.DateOf(7, 0, 0))
.WithSimpleSchedule(m =>
m.WithIntervalInHours(1)
.WithRepeatCount(100)
//立即执行,执行次数 = 预计执行次数 - 错过的次数
//.WithMisfireHandlingInstructionNowWithRemainingCount()
//立即执行,执行次数不变
.WithMisfireHandlingInstructionNowWithExistingCount()
).Build();
scheduler.ScheduleJob(job, trigger);
执行结果如下:
5. WithMisfireHandlingInstructionFireAndProceed(哑火的任务合并到一次执行,下次正常执行)
var scheduler = StdSchedulerFactory.GetDefaultScheduler();
scheduler.Start();
//将键值对传给定时器
var job = JobBuilder.Create()
.Build();
var trigger = TriggerBuilder.Create()
.StartAt(DateBuilder.DateOf(7, 0, 0))
.WithCronSchedule("0 0 7-20 ? * MON-FRI", //7AM - 8PM每小时执行一次
//哑火的任务合并到一次执行,下次正常执行
m => m.WithMisfireHandlingInstructionFireAndProceed()
//追赶执行哑火的任务,下次正常执行
//m => m.WithMisfireHandlingInstructionIgnoreMisfires()
//什么都不做,下次正常执行
//m => m.WithMisfireHandlingInstructionDoNothing()
)
.Build();
scheduler.ScheduleJob(job, trigger);
执行结果如下:
6. WithMisfireHandlingInstructionIgnoreMisfires(追赶执行哑火的任务,下次正常执行)
将5的 m => m.WithMisfireHandlingInstructionIgnoreMisfires()取消注释后,运行结果如下:
7. WithMisfireHandlingInstructionDoNothing(什么都不做,下次正常执行)
将5的 m => m.WithMisfireHandlingInstructionDoNothing()取消注释后,运行结果如下:
相关链接:
Quartz.NET中Job和Trigger的常用方法
Quartz.NET中设置特定日期的Calendar