Quartz.net入门

简介

Quartz.NET是一个开源的作业调度框架，是OpenSymphony的 Quartz API的.NET移植，
它用C#写成，可用于winform和asp.net应用中。它提供了巨大的灵活性而不牺牲简单性。
你能够用它来为执行一个作业而创建简单的或复杂的调度。它有很多特征，
如：数据库支持，集群，插件，支持cron-like表达式等等。

https://www.quartz-scheduler.net/documentation/quartz-3.x/tutorial/index.html

Nuget

1.一旦调度程序被实例化，它就可以启动，进入待机模式，并关机。请注意，一旦调度程序关闭，不能重新启动而不被重新实例化。触发器不会触发（作业不会执行），直到调度程序启动，也不会处于暂停状态。

    public class Program
    {
        private static void Main(string[] args)
        {
            // construct a scheduler factory
            ISchedulerFactory schedFact = new StdSchedulerFactory();

            // get a scheduler
            IScheduler sched = schedFact.GetScheduler();
            sched.Start();

            // define the job and tie it to our HelloJob class
            IJobDetail job = JobBuilder.Create<HelloJob>()
                .WithIdentity("myJob", "group1")
                .Build();

            // Trigger the job to run now, and then every 40 seconds
            ITrigger trigger = TriggerBuilder.Create()
              .WithIdentity("myTrigger", "group1")
              .StartNow()
              .WithSimpleSchedule(x => x
                  .WithIntervalInSeconds()
                  .RepeatForever())
              .Build();

            sched.ScheduleJob(job, trigger);
            Thread.Sleep(TimeSpan.FromSeconds());
            sched.Shutdown();
            //关闭后，重新启动计划异常
            //sched.Start();

            Console.WriteLine($"Press any key to close the application!{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")}");
            Console.ReadKey();
        }
    }

    public class HelloJob : IJob
    {
        public void Execute(IJobExecutionContext context)
        {
            Console.WriteLine($"Greetings from HelloJob!{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")}");
        }
    }

2.接口和静态方法

IScheduler - 与调度程序交互的主要API。
IJob - 您希望由调度程序执行的组件实现的接口。
IJobDetail - 用于定义作业的实例。
ITrigger - 定义执行给定Job的时间表的组件。
JobBuilder - 用于定义/构建JobDetail实例，它定义了Jobs的实例。
TriggerBuilder - 用于定义/构建触发器实例。

3.参数传递

namespace quartz.net
{
    public class Program
    {
        private static void Main(string[] args)
        {
            // construct a scheduler factory
            ISchedulerFactory schedFact = new StdSchedulerFactory();

            // get a scheduler
            IScheduler sched = schedFact.GetScheduler();
            sched.Start();

            // define the job and tie it to our HelloJob class
            IJobDetail job = JobBuilder.Create<HelloJob>()
                .WithIdentity("myJob", "group1")
                //JobDataMap可以用来保存任何数量的（可序列化的）对象，当你执行任务时，你希望这些对象可用。JobDataMap是IDictionary接口的一个实现，并且增加了一些方便的方法来存储和检索原始类型的数据。
                .UsingJobData("JobSays", "Hello World!")
                .UsingJobData("FloatValue", 3.141f)
                .Build();

            // Trigger the job to run now, and then every 40 seconds
            ITrigger trigger = TriggerBuilder.Create()
              .WithIdentity("myTrigger", "group1")
              .StartNow()
              .WithSimpleSchedule(x => x
                  .WithIntervalInSeconds()
                  .RepeatForever())
              .Build();

            sched.ScheduleJob(job, trigger);
            Thread.Sleep(TimeSpan.FromSeconds());
            sched.Shutdown();
            //关闭后，重新启动计划异常
            //sched.Start();

            Console.WriteLine($"Press any key to close the application!{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")}");
            Console.ReadKey();
        }
    }

    public class HelloJob : IJob
    {
        public string JobSays { private get; set; }
        public float FloatValue { private get; set; }
        public void Execute(IJobExecutionContext context)
        {
            JobKey key = context.JobDetail.Key;
            //从JobDataMap获取值
            //JobDataMap dataMap = context.JobDetail.JobDataMap;
            //string jobSays = dataMap.GetString("JobSays");
            //float myFloatValue = dataMap.GetFloat("FloatValue");

            Console.Error.WriteLine("Instance " + key + " of DumbJob says: " + JobSays + ", and val is: " + FloatValue);
            Console.WriteLine($"Greetings from HelloJob!{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")}");
        }
    }
}

4.配置任务出发时间次数

            //在特定的时刻建立一个触发器，不要重复：
            ISimpleTrigger trigger = (ISimpleTrigger)TriggerBuilder.Create()
               .WithIdentity("trigger1", "group1")
               .StartAt(DateTimeOffset.Now) // some Date
               .ForJob("myJob", "group1") // identify job with name, group strings
               .Build();

            //建立一个触发器，将在未来5秒触发一次：
            ISimpleTrigger trigger = (ISimpleTrigger)TriggerBuilder.Create()
                .WithIdentity("trigger5", "group1")
                .StartAt(DateBuilder.FutureDate(, IntervalUnit.Second)) // use DateBuilder to create a date in the future
                .ForJob(job) // identify job with its JobKey
                .Build();
            sched.ScheduleJob(job,trigger);

            ISimpleTrigger trigger = (ISimpleTrigger)TriggerBuilder.Create()
                .WithIdentity("trigger3", "group1")
                .StartNow()
                .WithSimpleSchedule(x => x.WithIntervalInSeconds().WithRepeatCount()) // note that 10 repeats will give a total of 11 firings
                .ForJob(myJob) // identify job with handle to its JobDetail itself
                .Build();

            var trigger = TriggerBuilder.Create()
            .WithIdentity("trigger7", "group1")
            .WithSimpleSchedule(x => x
                .WithIntervalInSeconds()
                .RepeatForever())
                .EndAt(DateBuilder.DateOf(, , ))
                .Build();

5.CronTrigger

Cron-Expressions用于配置CronTrigger的实例。Cron-Expressions是由七个子表达式组成的字符串，
它们描述了计划的各个细节。这些子表达式用空格分隔，表示：
秒
分钟
小时
日（MON - SUN）
月（为0到11之间的值）
星期X
年份（可选字段）

*字符可以用来表示该字段的“每个”可能的值。
/字符可用于指定增量值。
例如，如果您在“分钟”字段中输入“0/15”，则意味着“每15分钟，从零开始”。
如果在“分钟”字段中使用了“3/20”，则意味着“每小时20分钟，从第三分钟开始” - 或者换句话说，就是在分钟中指定“3,23,43”领域。

？字符被允许用于日期和星期几字段。
它用来指定“没有具体的价值”。
当你需要在两个字段中的一个字段中指定某些内容时，这是非常有用的，而不是其他的。请参阅下面的示例（和CronTrigger API文档）进行说明。

月份和星期几字段允许使用“L”字符。这个角色对于“最后”来说是短暂的，但是在两个领域中的每一个都有不同的含义。例如，月份字段中的值“L”意味着“月份的最后一天”，
即非闰年的2月28日的1月31日。如果单独使用在星期几字段中，则仅表示“7”或“SAT”。但是，如果在星期几字段中使用另一个值，则表示“本月的最后一个xxx日”，
例如“6L”或“FRIL”都表示“本月的最后一个星期五”。当使用“L”选项时，不要指定列表或值的范围，因为您会得到令人困惑的结果。

“W”用于指定与指定日期最近的星期几（星期一至星期五）。例如，如果您要指定“15W”作为月份日期字段的值，则其含义是：“最近的星期几到本月15日”。

“＃”用于指定该月的第n个“XXX”工作日。例如，星期几字段中的“6＃3”或“FRI＃3”的值表示“月的第三个星期五”。

"0 0 12？* WED" 每个星期三中午12:00触发
"0 0/5 * * * ?" 每5分钟触发
"0 30 10-13 ? * WED,FRI"每周三和周五的10:，:，:30和13:30发生的触发器