第九节: 利用RemoteScheduler实现Sheduler的远程控制 第八节: Quartz.Net五大构件之SimpleThreadPool及其四种配置方案 第六节: 六类Calander处理六种不同的时间场景 第五节: Quartz.Net五大构件之Trigger的四大触发类 第三节: Quartz.Net五大构件之Scheduler(创建、封装、基本方法等)和Job(创建、关联

第九节: 利用RemoteScheduler实现Sheduler的远程控制

 

一. RemoteScheduler远程控制

1. 背景: 在A服务器上部署了一个Scheduler,我们想在B服务器上控制这个Scheduler。

2. 猜想: A服务器上的Scheduler需要有地址、需要有端口、需要有名称(实际上也是如此)。

3. 需求: 一个控制台程序作为服务端运行A服务器上(也可以部署成服务),用另一个B服务器上的Web端控制来控制这个Scheduler的暂停、继续等操作。

4. 具体实现

  ①:A服务器上的Server端的Scheduler需要配置port和bindName两个核心参数,用来对外公开。

  ②:B服务器上Client端的Scheduler的创建需要使用代理,并配置其地址(A服务器上对外公开的)。

(原理:通过代理获取A服务器中的Scheduler,然后获取里面的job和trigger,然后可以配置job和trigger的开启、关闭、编辑等,这里以操控job的暂停和继续为例,介绍其使用思路,详细的如何操控trigger或者编辑等,详解后面框架章节)

 代码分享:

(1). A服务器上,即被控制端的Server端,这里我们用控制台程序代替。

  (PS:核心点就是StdSchedulerFactory类需要配置 type、port、bindName )

复制代码
 1  public class RemoteSchedulerServer
 2     {
 3         public static void ShowRemoteScheduler()
 4         {
 5             //1. 配置调度器工厂
 6             var schedulerFactory = new StdSchedulerFactory(new NameValueCollection()
 7             {
 8                 {"quartz.scheduler.exporter.type","Quartz.Simpl.RemotingSchedulerExporter,Quartz" },
 9                 {"quartz.scheduler.exporter.port","5555" },
10                 {"quartz.scheduler.exporter.bindName","QuartzScheduler" },
11             });
12             //2. 创建调度器
13             var scheduler = schedulerFactory.GetScheduler();
14             //3. 配置job和trigger并开启
15             var job = JobBuilder.Create<HelloJob4>()
16                 .WithIdentity("myJob1", "jobGroup1")
17                 .Build();
18             var trigger = TriggerBuilder.Create()
19                 .WithIdentity("myJobTrigger1", "triggerGroup1")
20                 .StartNow()
21                 .WithCronSchedule("/1 * * ? * *")
22                 .Build();
23             scheduler.ScheduleJob(job, trigger);
24             scheduler.Start();
25         }
26     }
复制代码

(2). B服务器,即Client端,用来操控A服务器上Scheduler,下面的代码我在操控job暂停和继续的时候,直接把jobName和GroupName写死了,这里只是为了演示用法而已,实际上可以通过远程代理创建的scheduler来获取所有的job和trigger的。

  (PS:核心点就是StdSchedulerFactory类需要配置 代理,并配置代理地址,即A服务器的地址、port、bindName )

复制代码
 1  public class RemoteSchedulerController : Controller
 2     {     
 3         /// <summary>
 4         /// 前端页面
 5         /// </summary>
 6         /// <returns></returns>
 7         public ActionResult Index()
 8         {
 9             return View();
10         }
11         /// <summary>
12         /// 使用代理的方式创建Sheduler
13         /// </summary>
14         static IScheduler scheduler = null;
15         public RemoteSchedulerController()
16         {
17             var schedulerFactory = new StdSchedulerFactory(new System.Collections.Specialized.NameValueCollection()
18             {
19                  {"quartz.scheduler.proxy","true" },  //使用代理
20                  {"quartz.scheduler.proxy.Address","tcp://localhost:5555/QuartzScheduler" }    //Server端的地址是多少,localhost就是多少
21             });
22             scheduler = schedulerFactory.GetScheduler();
23             scheduler.Start();
24         }
25         /// <summary>
26         /// 暂停Job 
27         /// (这里直接从前端默认把名称传过来,实际可以从scheduler中拿到)
28         /// </summary>
29         /// <returns></returns>
30         public ActionResult PauseJob(string jobName, string groupName)
31         {
32             try
33             {
34                 scheduler.PauseJob(new JobKey(jobName, groupName));
35                 return Content("ok");
36             }
37             catch (Exception)
38             {
39 
40                 return Content("error");
41             }
42             
43         }
44         /// <summary>
45         /// 恢复Job
46         /// </summary>
47         /// <returns></returns>
48         public ActionResult ResumeJob(string jobName, string groupName)
49         {
50             try
51             {
52                 scheduler.ResumeJob(new JobKey(jobName, groupName));
53                 return Content("ok");
54             }
55             catch (Exception)
56             {
57 
58                 return Content("error");
59             }
60         }
61     }
复制代码
复制代码
 1 <html>
 2 <head>
 3     <meta name="viewport" content="width=device-width" />
 4     <title>Index</title>
 5     <script src="~/Scripts/jquery-1.10.2.min.js"></script>
 6     <script>
 7         $(function () {
 8             //1. 暂停
 9             $("#btn1").on("click", function () {
10                 $.post("PauseJob", { "jobName": "myJob1", "groupName": "jobGroup1" }, function (data) {
11                     if (data=="ok") {
12                         alert("暂停成功");
13                     } else {
14                         alert("失败了");
15                     }
16                 });
17             });
18             //2. 继续
19             $("#btn2").on("click", function () {
20                 $.post("ResumeJob", { "jobName": "myJob1", "groupName": "jobGroup1" }, function (data) {
21                     if (data == "ok") {
22                         alert("继续成功");
23                     } else {
24                         alert("失败了");
25                     }
26                 });
27             });
28         });
29     </script>
30 </head>
31 <body>
32     <div>
33         远程操控另一个服务器端的Sheduler
34     </div>
35     <p></p><p></p><p></p>
36     <button id="btn1">暂停</button>
37     <button id="btn2">继续</button>
38 </body>
39 </html>
复制代码

(3). 运行结果

 

 

 

 

 

 

第八节: Quartz.Net五大构件之SimpleThreadPool及其四种配置方案

 

一. 简介

 

揭秘: SimpleThreadPool是Quartz.Net中自带的线程池,默认个数为10个,代表一个Scheduler同一时刻并发的最多只能执行10个job,超过10个的job需要排队等待。

 

二. 四种配置方案

 1. NameValueCollection的方式

  需要利用StdSchedulerFactory的构造函数进行传进去,向哪个Sheduler中传,即配置哪个Sheduler的对应的线程池。

代码分享:

复制代码
 1    {
 2                 var pairs = new System.Collections.Specialized.NameValueCollection() { };
 3                 pairs.Add("quartz.threadPool.ThreadCount", "20");   //设置线程池个数为20
 4 
 5                 var factory = new StdSchedulerFactory(pairs);      //将前面的配置加到Scheduler工厂中
 6                 var scheduler = factory.GetScheduler();
 7                 scheduler.Start();
 8 
 9                 var meta = scheduler.GetMetaData();
10                 int threadPoolSize = meta.ThreadPoolSize;
11                 Console.WriteLine("线程池的个数为:{0}", threadPoolSize);
12    }
复制代码

2. App.config的方式配置,

  详见:App.config文件,该模式代码中不需要进行任何的额外配置,适用于所有的Sheduler。

 配置文件代码分享:

复制代码
 1 <?xml version="1.0" encoding="utf-8" ?>
 2 <configuration>
 3   <!--线程池个数设置   开始-->
 4   
 5   <configSections>
 6     <section name="quartz" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0,Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
 7   </configSections>
 8   <quartz>
 9     <!--设置Sheduler的线程池个数为22-->
10     <add key="quartz.threadPool.threadCount" value="22"/>    
11   </quartz>
12   
13   <!--线程池个数设置   结束-->
14   <startup>
15     <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6"/>
16   </startup>
17 </configuration>
复制代码

3. quartz.config文件的形式进行配置

  该模式代码中不需要进行任何的额外配置,适用于所有的Sheduler。

  用法:新建名为"quartz.config"的xml文件,在文件中写入:quartz.threadPool.threadCount=15 代表线程池个数设置为15, 同时要把该文件的属性设置为始终复制,使其可以生产到bin文件。

分享一下quartz.config中的代码

   PS:就一句话哦。

1 quartz.threadPool.threadCount=15

4. 通过代码设置电脑的环境变量来实现

  一句代码:Environment.SetEnvironmentVariable("quartz.threadPool.threadCount", "26"); 设置后,适用于所有的Sheduler。

 代码分享:

复制代码
   {
                //将线程池的个数设置为26
                Environment.SetEnvironmentVariable("quartz.threadPool.threadCount", "26");
                var factory = new StdSchedulerFactory();
                var scheduler = factory.GetScheduler();
                scheduler.Start();

                var meta = scheduler.GetMetaData();
                int threadPoolSize = meta.ThreadPoolSize;
                Console.WriteLine("线程池的个数为:{0}", threadPoolSize);
   }
复制代码

总结:以上4种方式的优先级为:quartz.config < app.config < 环境变量 < namevaluecollection  

 

第六节: 六类Calander处理六种不同的时间场景

 

  背景介绍及其使用

   该章节主要补充介绍,在前一章四类触发器的基础上配合六大Canlander来动态删减某些时间,来满足更多的应用场景。

1. DailyCalendar:动态排除某天的某些字段.

(需求:每天8-23点执行,每隔1s执行一次,但是21-22点这个区间不执行)

2. WeeklyCalendar:适合在星期几的维度上做“减法操作”

(需求:每天8-23点执行,每隔1s执行一次,但是周五这一天不执行)

3. HolidayCalendar:适合当年的某一天不能执行

(需求:每天8-23点执行,每隔1s执行一次,但是今年的6月16号这一天不执行)

4. MonthlyCalendar:适合某个月中的某一天不能执行

(需求:每天8-23点执行,每隔1s执行一次,但是每月的27号不执行)

5. AnnualCalendar:适合每年指定的某一天不能执行(有问题)

(需求:每天8-23点执行,每隔1s执行一次,但是每年的6月16号这一天不执行)

6. CronCalendar:字符串表达式来排除某一天,某一个月份,某一年都可以

 (需求:每天8-23点执行,每隔1s执行一次,但是2月27号这天不执行)

 代码分享:

复制代码
  1        public static void CalanderShow()
  2         {
  3             //1. 每天8-23点执行,每隔1s执行一次,但是21-22点这个区间不执行
  4             {
  5                 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
  6                 scheduler.Start();
  7                 //单独记录一个区间段 21-22点
  8                 DailyCalendar dailyCalendar = new DailyCalendar(DateBuilder.DateOf(21, 0, 0).DateTime,
  9                                                                 DateBuilder.DateOf(22, 0, 0).DateTime);
 10                 scheduler.AddCalendar("mycalendar", dailyCalendar, true, true);
 11 
 12                 var job = JobBuilder.Create<HelloJob>().Build();
 13                 var trigger = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
 14                                                       x => x.OnEveryDay()
 15                                                           .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
 16                                                           .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(23, 00))
 17                                                           .WithIntervalInSeconds(1)
 18                                                                   )
 19                                                      .ModifiedByCalendar("mycalendar")
 20                                                      .Build();
 21                 scheduler.ScheduleJob(job, trigger);
 22             }
 23 
 24             //2. 每天8-23点执行,每隔1s执行一次,但是周五这一天不执行
 25             {
 26                 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 27                 scheduler.Start();
 28                 //设定周五不能执行
 29                 WeeklyCalendar calendar = new WeeklyCalendar();
 30                 calendar.SetDayExcluded(DayOfWeek.Friday, true);
 31                 scheduler.AddCalendar("mycalendar", calendar, true, true);
 32 
 33                 var job = JobBuilder.Create<HelloJob>().Build();
 34                 var trigger = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
 35                                                       x => x.OnEveryDay()
 36                                                           .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
 37                                                           .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(23, 00))
 38                                                           .WithIntervalInSeconds(1)
 39                                                                   )
 40                                                      .ModifiedByCalendar("mycalendar")
 41                                                      .Build();
 42                 scheduler.ScheduleJob(job, trigger);
 43             }
 44 
 45             //3. 每天8-23点执行,每隔1s执行一次,但是当年6月16号这一天不执行
 46             {
 47                 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 48                 scheduler.Start();
 49                 HolidayCalendar calendar = new HolidayCalendar();
 50                 calendar.AddExcludedDate(DateTime.Parse("06-16"));    //把当年6月16日排除在外
 51 
 52                 scheduler.AddCalendar("mycalendar", calendar, true, true);
 53                 var job = JobBuilder.Create<HelloJob>().Build();
 54                 var trigger = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
 55                                                       x => x.OnEveryDay()
 56                                                           .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
 57                                                           .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(23, 00))
 58                                                           .WithIntervalInSeconds(1)
 59                                                                   )
 60                                                      .ModifiedByCalendar("mycalendar")
 61                                                      .Build();
 62                 scheduler.ScheduleJob(job, trigger);
 63 
 64             }
 65 
 66             //4. 每天8-23点执行,每隔1s执行一次,但是每月的27号不执行
 67             {
 68                 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 69                 scheduler.Start();
 70 
 71                 //指定月份中的某一天不能执行
 72                 MonthlyCalendar calendar = new MonthlyCalendar();
 73                 calendar.SetDayExcluded(27, true);  //将27号这天排除在外
 74                 scheduler.AddCalendar("mycalendar", calendar, true, true);
 75 
 76                 var job = JobBuilder.Create<HelloJob>().Build();
 77                 var trigger = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
 78                                                       x => x.OnEveryDay()
 79                                                           .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
 80                                                           .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(23, 00))
 81                                                           .WithIntervalInSeconds(1)
 82                                                                   )
 83                                                      .ModifiedByCalendar("mycalendar")
 84                                                      .Build();
 85 
 86                 scheduler.ScheduleJob(job, trigger);
 87             }
 88 
 89             //5. 每天8-23点执行,每隔1s执行一次,但是每年的6月16号这一天不执行
 90             {
 91                 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 92                 scheduler.Start();
 93 
 94                 AnnualCalendar calendar = new AnnualCalendar();
 95                 calendar.SetDayExcluded(DateTime.Parse("06-16"), true);  //把每年的6月16日排除在外
 96                 scheduler.AddCalendar("mycalendar", calendar, true, true);
 97 
 98                 var job = JobBuilder.Create<HelloJob>().Build();
 99                 var trigger = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
100                                                       x => x.OnEveryDay()
101                                                           .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
102                                                           .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(23, 00))
103                                                           .WithIntervalInSeconds(1)
104                                                                   )
105                                                      .ModifiedByCalendar("mycalendar")
106                                                      .Build();
107                 scheduler.ScheduleJob(job, trigger);
108             }
109 
110             //6.每天8-23点执行,每隔1s执行一次,但是2月27号这天不执行
111             {
112                 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
113                 scheduler.Start();
114 
115                 CronCalendar calendar = new CronCalendar("* * * 27 2 ?");
116                 scheduler.AddCalendar("mycalendar", calendar, true, true);
117 
118                 var job = JobBuilder.Create<HelloJob>().Build();
119                 var trigger = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
120                                                       x => x.OnEveryDay()
121                                                           .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
122                                                           .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(23, 00))
123                                                           .WithIntervalInSeconds(1)
124                                                                   )
125                                                      .ModifiedByCalendar("mycalendar")
126                                                      .Build();
127                 scheduler.ScheduleJob(job, trigger);
128             }
129 
130         }
复制代码

 

 

 

第五节: Quartz.Net五大构件之Trigger的四大触发类

 

一. WithSimpleSchedule(ISimpleTrigger)

1. 用途:时、分、秒上的轮询(和timer类似),实际开发中,该场景占绝大多数.

2. 轮询的种类:永远轮询和限定次数轮询.

3. 参数中的几个函数:

 A.执行间隔:

  ①.WithInterval(TimeSpan timeSpan):通用的间隔执行方法

  ②.WithIntervalInHours(int hours):以小时为间隔单位进行执行

  ③.WithIntervalInMinutes(int minutes):以分钟为间隔单位进行执行

  ④.WithIntervalInSeconds(int seconds):以秒为间隔单位进行执行

 B.执行时间:

  ①.WithRepeatCount(int repeatCount):执行多少次以后结束

  ②.RepeatForever():永远执行

  ③.repeatMinutelyForever():一分钟执行一次(永远执行)

      repeatMinutelyForever(int minutes):每隔几分钟执行一次(永远执行)

   repeatMinutelyForTotalCount(int count, int minutes):每隔几分钟执行一次(执行次数为count)

  类似的还有秒、小时。

 代码分享:

复制代码
 1  public static void SimpleTriggrShow()
 2         {
 3             //1. 创建Schedule
 4             IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();      
 5             //2. 创建Job
 6             var job1 = JobBuilder.Create<HelloJob>().Build();
 7             //3. 创建Trigger
 8             //1s执行一次,永远执行
 9             var trigger = TriggerBuilder.Create()
10                                         .WithSimpleSchedule(x => x.WithIntervalInSeconds(1).RepeatForever())
11                                         .Build();
12             //2s执行一次,执行10次
13             //var trigger = TriggerBuilder.Create()
14             //                            .WithSimpleSchedule(x => x.WithIntervalInSeconds(2).WithRepeatCount(10))
15             //                            .Build();
16             //注意这种用法:WithScheduler,表示1s执行一次,执行了5次
17             //var trigger = TriggerBuilder.Create()
18             //                            .WithSchedule(SimpleScheduleBuilder.RepeatSecondlyForTotalCount(5, 1))
19             //                            .Build();
20             //4. 开始调度
21             scheduler.ScheduleJob(job1, trigger);
22             scheduler.Start();
23         }
复制代码

 

二. WithCalendarIntervalSchedule (ICalendarTrigger)

1.用途:与日历相关

2.参数中的几个函数:

  ①.WithInterval(TimeSpan timeSpan):通用的间隔执行方法

  ②.WithIntervalInHours(int hours):以小时为间隔单位进行执行

  ③.WithIntervalInMinutes(int minutes):以分钟为间隔单位进行执行

  ④.WithIntervalInSeconds(int seconds):以秒为间隔单位进行执行

  ⑤.WithIntervalInDays(int days):以天为间隔单位进行执行

  ⑥.WithIntervalInMonths(int months):以月为间隔单位进行执行

代码分享:

复制代码
 1  public static void CalendarIntervalTriggerShow()
 2         {
 3             //1. 创建Schedule
 4             IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 5             scheduler.Start();
 6             //2. 创建Job
 7             var job1 = JobBuilder.Create<HelloJob>().Build();
 8             //3. 创建Trigger
 9             //3s执行一次,60s后结束
10             var trigger = TriggerBuilder.Create()
11                                         .WithCalendarIntervalSchedule(x => x.WithIntervalInSeconds(3))
12                                         .EndAt(DateTimeOffset.Now.AddSeconds(60))    //60s后结束
13                                         .Build();
14             //4. 开始调度
15             scheduler.ScheduleJob(job1, trigger);
16         }
复制代码

 

三. WithDailyTimeIntervalSchedule (IDailyTimeTrigger)

1. 用途:解决时间点的增、减、排除。

2. 核心函数:

  a. OnEveryDay:每天

  b. OnMondayThroughFriday:周一至周五,即工作日

  c. OnSaturdayAndSunday:周六至周天,即休息日

  d. OnDaysOfTheWeek:用数组的形式单独来指定一周中的哪几天

  e. StartingDailyAt:表示开始于几点 (区别于前面的StartAt)

  f. EndingDailyAt:表示结束于几点 (区别于前面的EndAt)

 代码分享:

复制代码
 1  public static void DailyTimeIntervalTriggerShow()
 2         {
 3             //1. 创建Schedule
 4             IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 5             //2. 创建Job
 6             var job1 = JobBuilder.Create<HelloJob>().Build();
 7             //3. 创建Trigger
 8             //每天8-20点,每半个小时执行一次(即8:00、8:30  。。。。   19:30、20:30)
 9             var trigger1 = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
10                                                    x => x.OnEveryDay()
11                                                        .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(8, 00))
12                                                        .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(20, 00))
13                                                        .WithIntervalInMinutes(30))
14                                                        .Build();
15 
16             //每个工作日的凌晨2点执行1次 (这里的设计是2点开始,2:01结束,每个一小时执行一次,说白了总共执行了一次)
17             //或者直接WithIntervalInHours替换成WithRepeatCount
18             var trigger2 = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
19                                                    x => x.OnMondayThroughFriday()
20                                                          .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(2, 00))
21                                                          .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(2, 01))
22                                                          .WithIntervalInHours(1))
23                                                          .Build();
24 
25             //每个周的周一和周四的2点执行1次  (这里的设计是2点开始,2:01结束,每个一小时执行一次,说白了总共执行了一次)
26             //或者直接WithIntervalInHours替换成WithRepeatCount
27             var trigger3 = TriggerBuilder.Create().WithDailyTimeIntervalSchedule(
28                                                  x => x.OnDaysOfTheWeek(new DayOfWeek[2] {
29                                                                         DayOfWeek.Monday, DayOfWeek.Thursday })
30                                                        .StartingDailyAt(TimeOfDay.HourAndMinuteOfDay(2, 00))
31                                                        .EndingDailyAt(TimeOfDay.HourAndMinuteOfDay(2, 01))
32                                                        .WithIntervalInHours(1))
33                                                        .Build();
34             //4. 开始调度
35             scheduler.ScheduleJob(job1, trigger1);
36             scheduler.Start();
37         }
复制代码

 

四. WithCronSchedule (ICronTrigger)

1. 用途:使用cron表达式代替硬编码,可以替代以上三种Trigger (详见:www.cnblogs.com/knowledgesea/p/4705796.html)

2. 规则:

   a  整体规则排列如下,且日和周必须有一个位数是 ?

    * * * * * *

    秒 分 时 日 月 周

  b  ?: 代表示模糊的意思,必须存在,且只能在日或周中的一个存在

  c  *: 最小单位轮询,在分钟的字段域里,表示每分钟;在小时的字段域里,表示每小时

  d  /: 表示递增: 如0/5在秒的字段域里,表示第0、5、15、20.... 秒   可以省略0,即 /5

  e  -: 表示范围, 如1-10在秒字段域里,表示1s、2s、3s到10s都执行

  f  ,: 表示并且, 如1,10,20在秒字段域里,表示1s,10s,20s都执行

  g #: 只能存在周这一个域,表示第几周的星期几,如果超出范围,则忽略不记,如2#4,表示第四周的星期二

  h  L: 表示last的意思: 天: 10L 表示本月的倒数第十天执行, 5L 表示本月的最后一个周四执行(暂不研究)

3. 补充一下秒、分、时、日、月、周的字段域范围

  秒: 0-59

  分: 0-59

  时: 0-23

  日: 1-31

  月: 1-12 或 JAN-DEC

  周: 1-7 或 SUN-SAT

  年:选填,可以留空, 1970-2099

4. 补充几个事例帮助理解:

  实例1:0**1*? note:每月1号凌晨都会被执行。

  实例2:0**?** note:每分钟的00秒被执行。

  实例3:0 10 18 ? 3 WEB note:每年3月的每个星期三,下午6点10分都会被触发

  实例4:0 10 18 15 3 ? note:每年三月的第15天,下午6点10分都会被触发

  实例5:0 10 18 1-5 * ? note:每月的1号到5号(包含每月1号和5号,每月共计5天都会被触发),下午6点10分都会被触发

  实例6:0 10-15 * ? * * note:每小时的第10分钟到第15分钟(包含每小时的第10分钟和第15分钟,每小时共计5分钟都会被触发),都会被触发

  实例7:10,20 * * ? * * note:每分钟的第10秒与第20秒都会被触发

  实例8:0 10,20 * 1,2 * ? note:每月的第1天与第2天的,每小时的第10分钟与第20分钟被触发。

  实例9:5/20 * * ? * * note:每分钟的第5秒,第25秒,第45秒 都会被执行。

  实例10:0 * 2/2 ? * * note:每天的第2小时,第4小时,第6小时,第8小时 ... 第22小时的00分00秒都会被触发。

  实例11:* * * ? * 3#4 note:每月的第4个星期的周2,凌晨触发。

  实例12:* * * ? * 6#2 note:每月的第2个星期的周5,凌晨触发

代码分享:

复制代码
 1   public static void CronTriggerShow()
 2         {
 3             //1. 创建Schedule
 4             IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 5             scheduler.Start();
 6 
 7             //2. 创建Job
 8             var job1 = JobBuilder.Create<HelloJob>().Build();
 9 
10             //3. 创建Trigger
11 
12             //每天8-20点,每半个小时执行一次(即8:00、8:30  。。。。   19:30、20:30)
13             var trigger1 = TriggerBuilder.Create().WithCronSchedule("0 0/30 8-20 * * ?")
14                                                   .Build();
15             //每个工作日的凌晨2点执行1次     
16             var trigger2 = TriggerBuilder.Create().WithCronSchedule("0 0 2 ? * Mon-Fri")
17                                                   .Build();
18 
19             //每个周的周一和周四的2点执行1次
20             var trigger3 = TriggerBuilder.Create().WithCronSchedule("0 0 2 ? * Mon,Wes")
21                                                   .Build();
22 
23 
24             //4. 开始调度
25             scheduler.ScheduleJob(job1, trigger2);
26         }
复制代码

 

 

第三节: Quartz.Net五大构件之Scheduler(创建、封装、基本方法等)和Job(创建、关联等)

 

一. 五大构件

引言: Quartz.Net的五大构件

  1.  调度器:Scheduler

  2.  作业任务:Job

  3.  触发器: Trigger

  4.  线程池: SimpleThreadPool

  5.  作业持久化:JobStore

 

 

二. Scheduler详解

1. 创建Scheduler的两种方式

  (1). 直接通过StdSchedulerFactory类的GetDefaultScheduler方法创建

  (2). 先创建StdSchedulerFactory,然后通过GetScheduler方法创建. 该方式可以在实体化StdSchedulerFactory的时候配置一些额外的信息,比如:配置SimpleThreadPool的个数、RemoteScheduler的远程控制、数据库的持久化等。(都在后续章节介绍)

2. Scheduler的简单封装

  这里提供两种思路,一种是单例的模式封装,另一种是利用线程槽的模式封装

  (1). 单例模式:是指无论多少个用户访问,都只有一个实例,在web端上常用 (详见:MySchedulerFactory类)

  (2). 线程槽模式:是指单个用户的单次链接,在未断开连接之前,只有一个实例,下次重新连接,实例将重新创建(详见:MySchedulerFactory2类)

代码分享:

复制代码
 1     /// <summary>
 2     /// 将Sheduler封装成单例模式,解决多线程多用户不唯一的问题
 3     /// </summary>
 4     public class MySchedulerFactory
 5     {
 6         /// <summary>
 7         /// 静态变量:由CLR保证,在程序第一次使用该类之前被调用,而且只调用一次
 8         /// </summary>
 9         private static IScheduler _Scheduler = StdSchedulerFactory.GetDefaultScheduler();
10         public static IScheduler CreateScheduler()
11         {
12             return _Scheduler;
13         }
14     }
15     /// <summary>
16     /// 通过线程槽进行一个优化
17     /// </summary>
18     public class MySchedulerFactory2
19     {
20         public static IScheduler CreateScheduler()
21         {
22             IScheduler scheduler = CallContext.GetData(typeof(MySchedulerFactory2).Name) as IScheduler;
23             if (scheduler == null)
24             {
25                 scheduler = StdSchedulerFactory.GetDefaultScheduler();
26                 CallContext.SetData(typeof(MySchedulerFactory2).Name, scheduler);
27             }
28             return scheduler;
29         }
30     }
复制代码

3. Scheduler的基本方法:

(1). 开启:Start

(2). 关闭:ShutDown

(3). 暂停job或Trigger:PauseAll、PauseJob、PauseJobs、PauseTrigger、PauseTriggers

(4). 恢复job或Trigger:ResumeAll、ResumeJob、ResumeJobs、ResumeTrigger、ResumeTriggers

(5). 将job和trigger加入Scheduler中:ScheduleJob

(6). 添加Job:AddJob

  PS:更多方法以及如何封装使用,将在后面的框架章节介绍

 分享一段完成的代码:

复制代码
 1  public static void SchedulerShow()
 2         {
 3             //1.创建Scheduler有两种方式
 4             //方式一:直接通过StdSchedulerFactory类的GetDefaultScheduler方法创建
 5             IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
 6             //方式二:先创建StdSchedulerFactory,然后通过GetScheduler方法创建
 7             var factory = new StdSchedulerFactory();
 8             IScheduler scheduler2 = factory.GetScheduler();
 9 
10             //2.创建一个具体的作业即job (具体的job需要单独在一个文件中执行)
11             var job = JobBuilder.Create<HelloJob>().Build();
12 
13             //3.创建并配置一个触发器即trigger   1s执行一次
14             var trigger = TriggerBuilder.Create().WithSimpleSchedule(x => x.WithIntervalInSeconds(1)
15                                                                            .RepeatForever()).Build();
16             //4.将job和trigger加入到作业调度池中
17             scheduler.ScheduleJob(job, trigger);
18 
19             //5.开启调度
20             scheduler.Start();
21         }
复制代码

 

三. Job详解

1. 几个类型

  ①. JobBuilder:用来创建JobDetail。

  ②. IJob:具体作业任务需要实现该接口,并实现里面的方法

  ③. IJobDetail:用来定义工作实例

2. job的创建有两种形式:

  ①.Create的泛型方式:写起来代码简洁方便。

  ②.反射+OfType的方式:用于后期动态绑定,通过程序集的反射

复制代码
 1              //1 (Create的泛型方式)
 2             IJobDetail job1 = JobBuilder.Create<HelloJob2>()
 3                     .UsingJobData("name", "ypf")
 4                     .UsingJobData("age", "12")
 5                     .WithIdentity("job1", "myJob1")
 6                     .WithDescription("我是用来对该job进行描述的")
 7                     .StoreDurably(true)
 8                     .Build();
 9 
10             //2 (反射+OfType的方式)
11             //通过反射来创建类
12             var type = Assembly.Load("QuartzDemo").CreateInstance("QuartzDemo.HelloJob2");
13             //OfType的方式加载类型
14             IJobDetail job2 = JobBuilder.Create().OfType(type.GetType())
15                                     .UsingJobData("name", "ypf")
16                                     .UsingJobData("age", "12")
17                                     .StoreDurably(true)
18                                     .Build();
复制代码

3.常用的几个方法

  ①.UsingJobData:给Job添加一些附加值,存储在JobDataMap里,可以在具体的Job中获取。(通过context.JobDetail.JobDataMap获取)

  ②.StoreDurably:让该job持久化,不被销毁.(默认情况下为false,即job没有对应的trigger的话,job就被销毁)

  ③.WithIdentity:身份标记,给job起个名称,便于和Trigger关联的时候使用.

  ④.WithDescription:用来对job进行描述,并没有什么实际作用

分享完整代码:

复制代码
       /// <summary>
        /// Job详解
        /// </summary>
        public static void JobShow()
        {
            //1. 创建Schedule
            IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
            
            //2. 创建Job
            //2.1 (Create的泛型方式)
            IJobDetail job1 = JobBuilder.Create<HelloJob2>()
                    .UsingJobData("name", "ypf")
                    .UsingJobData("age", "12")
                    .WithIdentity("job1", "myJob1")
                    .WithDescription("我是用来对该job进行描述的")
                    .StoreDurably(true)
                    .Build();

            //2.2 (反射+OfType的方式)
            //通过反射来创建类
            var type = Assembly.Load("QuartzDemo").CreateInstance("QuartzDemo.HelloJob2");
            //OfType的方式加载类型
            IJobDetail job2 = JobBuilder.Create().OfType(type.GetType())
                                    .UsingJobData("name", "ypf")
                                    .UsingJobData("age", "12")
                                    .StoreDurably(true)
                                    .Build();
            IJobDetail job3 = JobBuilder.Create(type.GetType())
                                 .UsingJobData("name", "ypf")
                                 .UsingJobData("age", "12")
                                 .StoreDurably(true)
                                 .Build();

            //3. 创建Trigger
            ITrigger trigger = TriggerBuilder.Create().WithSimpleSchedule(x => x.WithIntervalInSeconds(1).RepeatForever()).Build();

            //4. 将Job和Trigger加入调度器中
            //scheduler.ScheduleJob(job1, trigger);
            //scheduler.ScheduleJob(job2, trigger);
            scheduler.ScheduleJob(job3, trigger);

            //5. 开始调度
            scheduler.Start();
        }
     /// <summary>
    /// 实现IJob接口
    /// </summary>
    class HelloJob2 : IJob
    {
        void IJob.Execute(IJobExecutionContext context)
        {
            var name = context.JobDetail.JobDataMap["name"];
            var age = context.JobDetail.JobDataMap["age"];

            Console.WriteLine("name值为:{0},age值为:{1}", name, age);
        }
    }
复制代码

运行结果:

4. Job和触发器关联的形式:1对1、1对多、多对1

 (PS:在下面Trigger处详细介绍)

 

第二节:比较DateTime和DateTimeOffset两种时间类型并介绍Quartz.Net中用到的几类时间形式(定点、四舍五入、倍数、递增)

 

一. 时间的类型

 1. 背景

   这里为什么要介绍时间类型呢,明明是定时调度篇,原因是在定时任务中,任务什么时间开始执行,什么时间结束执行,要用到各种各样的时间模式,虽然这不能算是一个复杂的问题,但在正式介绍Quartz.Net之前,还是很有必要补充一下的,该章节就是解决这类问题的。

 2.  时间类型

  时间类型主要有两类:DateTime和DateTimeOffset

      (详情参考:https://docs.microsoft.com/zh-cn/dotnet/standard/datetime/choosing-between-datetime)

 (1). DateTime:表示的时区有限,国内采用这个时间。

 (2). DateTimeOffset:可以表示任何时区,通过偏移量来控制。(Quartz中提供DateBuilder类来实现DateTimeOffset类型)

3. 类型转换

 (1). DateTime→DateTimeOffset 利用DateTimeOffset的构造函数

 (2). DateTimeOffset→DateTime 利用Convert.ToDateTime方法

 下面分享一段两种类型相互转换的代码:

复制代码
1 // DateTime类型
2 DateTime date1 = DateTime.Parse("2018-01-01 11:45:30");
3 //DateTimeOffset类型
4 DateTimeOffset date3 = DateBuilder.DateOf(11, 45, 30, 1, 1, 2018);
5 //1. DateTime 转换成 DateTimeOffset
6 DateTimeOffset date16 = new DateTimeOffset(date1, TimeSpan.Zero);
7 //2. DateTimeOffset 转换成 DateTime
8 DateTime date17 = Convert.ToDateTime(date3);
复制代码

二. 各种模式的表示

(一). 定点模式

1. 需求:

  a. 2018-01-01 11:45:30

  b. 01-01 1:45:30

  c. 1:45:30

2. 解决方案

(1). DateTime类

  a. 利用DateTime.Parse()进行转换,如:DateTime.Parse("2018-01-01 11:45:30");

  b. 利用DateTime类丰富的构造函数来执行, 如:new DateTime(2018, 1, 1, 11, 45, 30);

(2). DateTimeOffset类

  a. 利用DateBuilder.DateOf()进行转换,如:DateBuilder.DateOf(11, 45, 30, 1, 1, 2018);

  b. 利用DateTimeOffset类丰富的构造函数来执行, 如: new DateTimeOffset(2018, 1, 1, 11, 45, 30, TimeSpan.Zero);

  c. 另外,DateBuilder类还提供 TodayAt和TomorrowAt类,便于在当前年月日的基础上进行处理

代码分享:

 

复制代码
1             DateTime date1 = DateTime.Parse("2018-01-01 11:45:30");
2             DateTime date2 = new DateTime(2018, 1, 1, 11, 45, 30);
3             DateTimeOffset date3 = DateBuilder.DateOf(11, 45, 30, 1, 1, 2018);
4             DateTimeOffset date4 = new DateTimeOffset(2018, 1, 1, 11, 45, 30, TimeSpan.Zero);
5             //默认为当前年月日
6             DateTimeOffset date5 = DateBuilder.TodayAt(1, 45, 30);
7             //默认为当前年月日的基础上 + 1天
8             DateTimeOffset date6 = DateBuilder.TomorrowAt(1, 45, 30);
复制代码

(二). 四舍五入的模式

1. 需求:1:45:30 → 2:00:00

        → 1:00:00

2. 解决方案:

  (1).DateBuilder.EvenHourDate 在小时的基础上进行“入”

  (2).DateBuilder.EvenHourDateBefore 在小时的基础上进行“舍”

  (3).另外在分钟的基础上进行入和舍有: EvenMinuteDate和EvenMinuteDateBefore

       在秒钟的基础上进行入和舍有: EvenSecondDate和EvenSecondDateBefore

 代码分享:

1 DateTimeOffset date5 = DateBuilder.TodayAt(1, 45, 30);
2 DateTimeOffset date7 = DateBuilder.EvenHourDate(date5);           //当前年月日下:2:00:00
3 DateTimeOffset date8 = DateBuilder.EvenHourDateBefore(date5);     //当前年月日下:1:00:00

(三). 倍数模式(不常用)

1. 包括:NextGivenMinuteDate和NextGivenSecondDate

  以NextGivenMinuteDate为例,说明它的用法,NextGivenSecondDate与他类似

  查看源码:public static DateTimeOffset NextGivenMinuteDate(DateTimeOffset? date, int minuteBase);

第一个参数:可以为空,也可以指定时间

第二个参数:把一个小时按minuteBase分钟进行划分,也就是60/minuteBase等份,真正的运行时间所在区间的下一个minuteBase分钟运行,

(PS:比如minuteBase=20,那么就是将分钟划分为3等分,分别是:20、40、60, 比如现在分钟是在 0-19分59秒,任何一个都会变为 20分00秒)

2. 用法:第一个参数为空的话,取的是当前时间为依据。

    第一个参数有值的话,是以第一个参数为依据。

代码分享:

 //以当前时间为依据,假设当前时间为:14:43:29   d9=14:50:00    d10=15:00:00           
DateTimeOffset d9 = DateBuilder.NextGivenMinuteDate(null, 10); DateTimeOffset d10 = DateBuilder.NextGivenMinuteDate(null, 20); //以第一个参数为依据 DateTimeOffset date9 = DateBuilder.NextGivenMinuteDate(DateBuilder.TodayAt(1, 45, 30), 10); //50分 秒数为0 DateTimeOffset date10 = DateBuilder.NextGivenMinuteDate(new DateTime(2018, 1, 1, 11, 25, 30), 20); //40分 秒数为0

(四). 递增模式

1. 需求:解决在某个时间点上增加:秒、分、分钟、小时、或天、月等。

2. 解决方案:

  利用DateTime类中的各种Add函数来解决。

  常用方法有:AddSeconds、AddMinutes、AddHours、AddDays、AddMonths

 代码分享:

1 DateTime date1 = DateTime.Parse("2018-01-01 11:45:30");
2 DateTime date11 = date1.AddSeconds(1);     //2018-01-01 11:45:31
3 DateTime date12 = date1.AddMinutes(1);     //2018-01-01 11:46:30
4 DateTime date13 = date1.AddHours(1);       //2018-01-01 12:45:30
5 DateTime date14 = date1.AddDays(1);        //2018-01-02 11:45:30
6 DateTime date15 = date1.AddMonths(1);      //2018-02-01 11:45:30            

 

 

 

posted @ 2018-07-07 19:36  ~雨落忧伤~  阅读(146)  评论(0编辑  收藏  举报