任务调度系统Quartz.net详解1-基本流程及Core表达式

Quartz.NET是一个强大、开源、轻量级的任务调度框架。常见的定时任务比如：

Quartz包含以下5个基本部分：

1. Scheduler:调度器，也可认为是quartz工作时的独立容器
2. Trigger:触发器，定义了调度任务的时间规则，也就是什么时候去执行任务
3. Job:需要执行的任务
4. ThreadPool:线程池（不是clr中的线程池），任务最终交给线程池中的线程执行
5. JobStore:分为RAWStore和DbStore两种，job和trigger都存放在JobStore中

Quartz的基本工作流程

scheduler是quartz的独立运行容器，trigger和job都可以注册在scheduler容器中，其中trigger是触发器，用于定义调度任务的时间规则，job是被调度的任务，一个job可以有多个触发器，而一个触发器只能属于一个job。

Quartz中有一个调度线程QuartzSchedulerThread，调度线程可以找到将要被触发的trigger，通过trigger找到要执行的job，然后在ThreadPool中获取一个线程来执行这个job。

JobStore主要作用是存放job和trigger的信息。

基本使用

1. nuget安装Quartz

2. 定义一个任务

//自定义工作任务，需要实现IJob接口
public class MyJob : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        await Task.Run(() =>
        {
            Console.WriteLine("我是一个自定义任务");
            Console.WriteLine($"我的任务名称是：{context.JobDetail.Key}");
        });
    }
}

3. 总体实现

static void Main(string[] args)
{
    //通过调度工厂获取一个调度器实例
    StdSchedulerFactory factory = new StdSchedulerFactory();
    IScheduler scheduler = factory.GetScheduler().Result;

    //创建job
    IJobDetail job = JobBuilder
                    .Create<MyJob>() //创建一个jobBuilder
                    .WithIdentity("jobName", "jonGroup") //辨识名称和分组
                    .WithDescription("增加一个描述")
                    .Build();  //生成IJobDetail

    //创建触发器
    ITrigger trigger = TriggerBuilder
                       .Create() //获取TriggerBuilder
                       //.StartAt(DateBuilder.TodayAt(01,34,00)) //开始时间，今天1点34分0秒（hh,mm,ss）
                       .StartNow() //也可以直接现在执行
                       .ForJob(job) //触发器关联的任务
                       .WithPriority(1) //优先级，触发时间一样时，优先级大的先执行
                       .WithIdentity("TriggerName","TriggerGroup") //辨识名称和分组
                       .WithSimpleSchedule(x=>x
                            .WithIntervalInSeconds(1)
                            .WithRepeatCount(3)
                            .Build()) //调度，一秒执行一次，共执行3次
                       .Build(); //利用TriggerBuilder创建ITrigger

    //start让调度线程启动
    //调度线程可以从jobstore中获取快要执行的trigger,然后获取trigger关联的job，执行job
    scheduler.Start();

    //将job和trigger注册到scheduler中
    //必须，否则不会执行任务
    scheduler.ScheduleJob(job, trigger).Wait();
    Console.WriteLine("执行成功");
    Console.ReadLine();
}

TriggerBuilder

TriggerBuilder顾名思义就是用来创建Trigger的。

Trigger的作用是定义Job何时执行。Quartz.net提供了四种触发策略：SimpleSchedule，CalendarIntervalSchedule，DailyTimeIntervalSchedule和CronSchedule。

SimpleSchedule

Simpleschedule 是最简单的一种触发策略，它的作用类似于timer，可以设置间隔几秒/几分钟/几小时执行一次，如创建一秒执行一次的触发器如下

.WithSimpleSchedule(x=>x
     .WithIntervalInSeconds(1)
     .WithRepeatCount(3)
     .Build()) //调度，一秒执行一次，共执行3次

CalendarIntervalSchedule

CalendarIntervalSchedule可以实现时分秒天周月年的维度上执行轮询。如创建一个月执行一次的触发器如下

.WithCalendarIntervalSchedule(x => x.WithIntervalInMonths(1)) //一月执行一次

DailyTimeIntervalSchedule

主要用于指定每周的某几天执行，如我们想让每周的周六周日的8:00-20:00，每两秒执行一次，创建触发器如下

.WithDailyTimeIntervalSchedule(x => x
          .OnDaysOfTheWeek(new DayOfWeek[] { DayOfWeek.Saturday, DayOfWeek.Sunday }) //周六和周日
          .StartingDailyAt(TimeOfDay.HourMinuteAndSecondOfDay(8, 00, 00)) //8点开始
          .EndingDailyAt(TimeOfDay.HourMinuteAndSecondOfDay(20, 00, 00))  //20点结束
          .WithIntervalInSeconds(2)                                       //两秒执行一次，可设置时分秒维度
          .WithRepeatCount(3))                                            //一共执行3+1次

CronSchedul

CronSchedule是应用最多的触发策略，通过Cron表达是我们可以轻松地表示任意的时间节点，下边的代码创建了一个每隔5秒执行一次的触发器

.WithCronSchedule("3/5 * * * * ?") //五秒执行一次

Core表达式

cron表达式有七个部分组成，以此是秒、分、时、天、月、周、年，其中年是可选的。

特殊值含义

案例：