Quartz.NET经常使用方法 01

 Quartz.NET做为一款定时框架，它的最小可运行程序以下：

    var scheduler = StdSchedulerFactory.GetDefaultScheduler(); scheduler.Start(); //Job执行的任务 var job = JobBuilder.Create<MyJob>().Build(); //Schedule计划表，能够设置调用次数，调用间隔 //Trigger触发器，能够设置调用开始，结束时间，优先级 var trigger = TriggerBuilder.Create().WithSimpleSchedule( m => m.WithIntervalInSeconds(1).WithRepeatCount(1)) .StartNow()//.EndAt(DateTimeOffset.Now.AddSeconds(10))  .Build(); scheduler.ScheduleJob(job, trigger);

 

它有两个核心要素：Job和Trigger，Job用于经过实现了IJob接口的泛型即PublishJob告诉框架作什么，而Trigger告诉框架什么时候作。

 

MyJob类：

    /// <summary> /// 自定义任务 /// </summary> public class MyJob : IJob { public void Execute(IJobExecutionContext context) { //实现具体的业务逻辑  } }

 

Job经常使用方法

UsingJobData(key, value)方法

经过这个方法能够给具体的任务实现类即上面的MyJob传值，例如： context.JobDetail.JobDataMap["count"]

 

WithDescription(description)方法

用于描述Job的名称，业务逻辑，我一开始还很奇怪任务的名称和业务逻辑彻底能够在代码中描述，为什么还要有这个方法，原来这个方法的使用场景是：自定义定时任务框架，好比开发一套相似于Windows定时任务的工具。

 

WithIdentity(name)

给JobKey命名，JobKey是JobBuilder的一个属性，它的底层代码以下：

    public JobBuilder WithIdentity(string name) { //new一个JobKey，name是key的名称，group名称是null key = new JobKey(name, null); return this; }

 

StoreDurably(durability)

是否持久化（默认当没有Trigger指向Job时，Job会被删掉）

 

SetJobData(newJobDataMap)

给JobDataMap设置一个新的对象，这个方法与上面的UsingJobData方法区别在于一个是给JobDataMap添加值，一个是从新给这个对象赋值，它们的底层代码以下。

 

SetJobData：

        public JobBuilder SetJobData(JobDataMap newJobDataMap) { jobDataMap = newJobDataMap; return this; }

UsingJobData：

        public JobBuilder UsingJobData(string key, string value) { jobDataMap.Put(key, value); return this; }

 

Trigger经常使用方法

StartAt(startTimeUtc) 方法

设置触发器开始执行的时间，这个参数是能够设置时区的。

 

Quartz.NET框架自身还封装了一个日期工具类 DateBuilder，它实现类不少返回下一分钟(小时，天等)方法，它与StartAt可以很好地配合。

例如：

DateBuilder.EvenMinuteDateAfterNow(); 返回如今时刻地下一分钟，例如：如今的时间是12点29分20秒，它会返回12点30分00秒

 

EndAt(endTimeUtc) 方法

与StartAt对应的是EndAt方法，它用于设置触发器的关闭时间

 

WithSimpleSchedule(action) 方法

建立了一个简单的执行计划，能够设置执行次数，频率等，这个方法是最经常使用的，咱们熟悉的Timer定时器就相似于这个。

它的参数是一个委托Action<SimpleScheduleBuilder>，咱们就是经过调用SimpleScheduleBuilder的方法来设置执行次数&间隔时间的。

 

WithDailyTimeIntervalSchedule(action) 方法

建立一个功能更强的执行计划，它能够设置天天几点到几点执行，工做日执行或只在周末执行，在执行了几回后中止，在某一个星期执行，设置执行频率等。

它的参数是一个委托Action<DailyTimeIntervalScheduleBuilder>，咱们就是经过调用DailyTimeIntervalScheduleBuilder的方法来设置执行策略的。

 

WithCronSchedule(cronExpression)方法

经过Corn表达式来设置执行计划，这种方式与上面两种的优势在于咱们能够再也不经过硬编码的方式来设置执行策略，而是经过字符串来控制执行策略。

 

语法以下：

        //秒 分 时 天 月 年 周 //1. 天或者周必须有一个是？（？表示模糊） //2. * 表示全部值即，秒位为*表示每秒执行一次 //3. - 表示范围，分钟位为10-12表示每一个小时的10，11，12分执行一次 //4. , 表示每一个值即，分钟位为10，20，30表示每一个小时的10，20，30分执行一次 //5. / 表示递增，秒位为0/5表示0，5，10，15，20，25，30，35，40，45，50，55秒执行一次 //例子： // * * * * * ? => 每秒执行一次 // 0/5 * * * * ? => 5s执行一次 // 0 * * * * ? => 1min执行一次 // 0 0 1 * * ? => 每月1号执行一次 // 地址：https://www.quartz-scheduler.net/documentation/quartz-2.x/tutorial/crontrigger.html