C# Quartz.NET实现动态改变作业调度周期

Quartz：Java编写的开源的任务调度作业框架 类似Timer之类定时执行的功能，但是更强大

Quartz.NET：是把Quartz转成C#  NuGet中可以直接下载对应类库

官网：https://www.quartz-scheduler.net/

主要对象:

Job ：工作，要执行的具体内容继承IJob。此接口中只有一个方法：execute(IJobExecutionContext context) 
JobDetail：具体的可执行的调度程序，Job 是这个可执行程调度程序所要执行的内容
Trigger：调度参数的配置，什么时候去调 执行间隔。 
Scheduler：调度容器，一个调度容器中可以注册多个 JobDetail 和 Trigger。当 Trigger 与 JobDetail 组合，就可以被 Scheduler 容器调度了。 
大体介绍：

static void Main(string[] args)
{
Task<IScheduler> task_scheduler = StdSchedulerFactory.GetDefaultScheduler();
IScheduler scheduler = task_scheduler.Result;

//ISchedulerFactory _SchedulerFactory = new StdSchedulerFactory();
//IScheduler scheduler = _SchedulerFactory.GetScheduler().Result;

/*
* 过程：
* 一.通过StdSchedulerFactory计划工厂对象创建调度计划Scheduler
* 二.创建Job对象，需要继承IJob 实现执行方法
* 三.触发对象，2种：间隔执行和定时执行
* 1.ITrigger:间隔执行
* 2.ICronTrigger:定时执行
* 四.将job对象和触发对象传入调度计划Scheduler 开始执行
*
*
*/
//job创建
IJobDetail job = JobBuilder.Create<SayHello>().WithIdentity("定时确认完成订单").Build();

////创建简单计时器
//ISimpleTrigger _SimpleTrigger = TriggerBuilder.Create()
// .WithSimpleSchedule(t => t //声明定时
// .WithIntervalInSeconds(2) //5秒一次
// .RepeatForever()) //永远执行
// .StartNow() //立即开始
// .Build() //创建
// as ISimpleTrigger;
////关联job与计时器
//scheduler.ScheduleJob(job, _SimpleTrigger);
/*
* WithCronSchedule参数说明：
* 秒 分 时 某一天 月 周 年(可选参数,一般不用)
* 秒分的合法值为0-59，小时:0-23，日期(天):0-31[要注意不同的月份中的天数不同] 月:0-11[或JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,OCT,NOV,DEC] 星期:1-7(1=星期日)或[SUN,MON,TUE,WED,THU,FRI,SAT] (程序员数数法。。 万事0开始)（ 涉及到星期最好用英文）
* 通配符{[, - * /]都可以使用、[L #]只能星期课额外使用、[L W]天数可额外使用}
* ',' 子条件
* '*' 代表任意值的所有
* '-' 代表一个时段
* '/' 代表值的增量
* 比如:分钟域中放入'0/15' 表示【从0开始 每隔15分钟】 '3/20'表示【从第3分钟开始 每隔20分钟】 等同【3,23,43】
* '?' 只能用在天数或者星期中 表示【没有指定值,满足所有】
* 'L' 只能用在天数或者星期中 表示【这个时段的最后一天】
* 比如：月份中 1月的31号 2月的28或者29号 反正最后一天，或者 4L:该月的最后一个周四 6L:该月的最后一个周四。
* 注意！星期中表示【周六 SAT（手动加粗）】
* 'W' 代表离给定日期最近的那个工作日
* 比如：天数设置为15W 表示【离本月15号最近的一个工作日】？？
* 'LW'代表这个月最后一周的工作日 可以在日期使用 ？待测
* '#' 代表本月的第几个工作日
* 比如：星期中设置6#3 当月的第三个周五（6是周五！）
*
* 过失触发：
* withMisfireHandlingInstructionDoNothing--->misfireInstruction = 2
* ——不触发立即执行
* ——等待下次Cron触发频率到达时刻开始按照Cron频率依次执行
*
* withMisfireHandlingInstructionFireAndProceed--->misfireInstruction = 1
* ——以当前时间为触发频率立刻触发一次执行
* ——然后按照Cron频率依次执行
*
* withMisfireHandlingInstructionIgnoreMisfires--->misfireInstruction = -1
* ——以错过的第一个频率时间立刻开始执行
* ——重做错过的所有频率周期后
* ——当下一次触发频率发生时间大于当前时间后，再按照正常的Cron频率依次执行
*
*
*
* 实例：
* "0 0/5 * * * ?" 每5分钟
* "10 0/5 * * * ?" 这分钟后 10 秒起, 每五分钟
* "0 30 10-13 ? * WED,FRI" 每周三、周五的10点到13点的30分时 【每周三, 周五 10:30, 11:30, 12:30 和 13:30】
* "0 0/30 8-9 5,20 * ?" 每个月的5号、20号的8点9点之间 每半小时触发一次 因为0开始 所以10点的时候不触发【8:00, 8:30, 9:00 9:30 】
* "0 0-5 14 * * ?" 每天的14:00到14:05分每分钟一次
* "0 10,44 14 ? 3 WED" 每年三月的周三14:10和14:44
* "0 15 10 ? * MON-FRI" 每周三到周五的10::15
* "0 15 10 ? * 6#3" 每个月第三个周五的10:15
*
* 生成表达式的网站：http://cron.qqe2.com/?tdsourcetag=s_pctim_aiomsg 小时模块的增量有bug注意下 但大体不影响使用
*/
ICronTrigger _CronTrigger = TriggerBuilder.Create()
.WithIdentity("定时确认")
.WithCronSchedule("0/2 * * * * ?") //秒 分 时 某一天 月 周 年(可选参数)
.Build()
as ICronTrigger;
scheduler.ScheduleJob(job, _CronTrigger);


scheduler.Start();
Console.ReadLine();
}
}

public class SayHello : IJob
{
public async Task Execute(IJobExecutionContext context)
{
Console.WriteLine("Hello Wrold!");
}
}
 

 

实例：

1.创建job

public class SayHello : IJob
{
public static int ii = 0;
static string str = "服务1=Cron 5秒一次。Hello World==SayHello ";
public async Task Execute(IJobExecutionContext context)
{

if (ii == 1)
{
QuartzManage.ModifyJob(context.JobDetail, context.Trigger as ICronTrigger, "0/2 * * * * ?");
ii = 0;
str += ",周期已改变！！变成2秒一次 ";
}
Common.WriteLog(str + context.Scheduler.GetHashCode());
}
}

public class SayCZ : IJob
{
public async Task Execute(IJobExecutionContext context)
{
Common.WriteLog("服务2=Simple 3秒一次。Hello CZ==SayCZ " + context.Scheduler.GetHashCode());
}
}
2.Quartz管理类

public class QuartzManage
{
static Task<IScheduler> task_scheduler = StdSchedulerFactory.GetDefaultScheduler();
static IScheduler scheduler;
private static readonly object objlock = new object();
static QuartzManage()
{
if (scheduler == null)
{
lock (objlock)
{
if (scheduler == null)
scheduler = task_scheduler.Result;
}
}
}

/// <summary>
/// 以Simple开始一个工作
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="name"></param>
/// <param name="simpleInterval"></param>
public static void StartJobWithSimple<T>(string name, Action<SimpleScheduleBuilder> simpleInterval) where T : IJob
{
IJobDetail job = JobBuilder.Create<T>().WithIdentity(name + "_job", name + "_group").Build();
ITrigger Simple = TriggerBuilder.Create().StartNow()
.WithSimpleSchedule(simpleInterval)
.Build() as ISimpleTrigger;

scheduler.ScheduleJob(job, Simple);
scheduler.Start();
}

/// <summary>
/// 以Cron开始一个工作
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="name"></param>
/// <param name="CronExpression"></param>
public static void StartJobWithCron<T>(string name, string CronExpression) where T : IJob
{

IJobDetail job = JobBuilder.Create<T>().WithIdentity(name + "_job", name + "_group").Build();

ITrigger CronTrigger = TriggerBuilder.Create().StartNow().WithIdentity(name + "_trigger", name + "_group")
.WithCronSchedule(CronExpression, w => w.WithMisfireHandlingInstructionDoNothing())
.Build() as ICronTrigger;

scheduler.ScheduleJob(job, CronTrigger);
scheduler.Start();
}

/// <summary>
/// Cron修改频率
/// </summary>
/// <param name="job"></param>
/// <param name="trigger"></param>
/// <param name="CronExpression"></param>
public static void ModifyJob(IJobDetail job, ICronTrigger trigger, string CronExpression)
{
ICronTrigger _ICronTrigger = trigger;
_ICronTrigger.CronExpressionString = CronExpression;

scheduler.RescheduleJob(trigger.Key, _ICronTrigger);
}

/// <summary>
/// Simple修改频率
/// </summary>
/// <param name="job"></param>
/// <param name="trigger"></param>
/// <param name="SimpleTime"></param>
public static void ModifyJob(IJobDetail job, ISimpleTrigger trigger, TimeSpan SimpleTime)
{
ISimpleTrigger _ISimpleTrigger = trigger;
_ISimpleTrigger.RepeatInterval = SimpleTime;

scheduler.RescheduleJob(trigger.Key, _ISimpleTrigger);
}

}
3.执行调度，并改变周期

public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}


/// <summary>
/// Cron
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void button1_Click(object sender, EventArgs e)
{
QuartzManage.StartJobWithCron<SayHello>("first", "0/5 * * * * ?");
}

/// <summary>
/// Simple运行
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void button2_Click(object sender, EventArgs e)
{
QuartzManage.StartJobWithSimple<SayCZ>("second", x => x.WithIntervalInSeconds(3).RepeatForever()); //每三秒 一直执行
}

private void button3_Click(object sender, EventArgs e)
{
SayHello.ii = 1;
}
}
执行结果：

 

改变周期后 会有一个过时触发的问题 根据设置不同的模式 执行的效果不同 misfire的概念，第一个代码块中有详细注释说明