Quartz.NET开源作业调度框架系列(二):CronTrigger

　　CronTriggers比SimpleTrigger更加的灵活和有用,对于比较复杂的任务触发规则,例如”每个星期天的晚上12:00″进行备份任务,SimpleTrigger就不能胜任,只能选择CronTriggers.利用CronTrigger, 你不但能实现在”每个星期天的晚上12:00″进行备份的任务,还可以执行  “在每个星期一/星期三/星期五的上午9:00到10:00期间每隔5 分钟”进行某个自动化任务.

1 Cron Expressions

　　Cron-Expressions 是用户配置实例化的CronTrigger. Cron-Expressions是一个6个或者7个字符的字符串表达式, 每一个字符都表示一个具体的含义并且有取值范围. 每个字符用空格进行分隔,其表达的意义为(从左到右):

　　一般来说Cron-Expressions 以6位居多,年一般省略.上图的中每个字符的描述为 字符的意义+取值范围(用[])+可用的特殊字符({}).例如  秒[0-59] { , – * /}就代表第一个字符是秒,取值范围是0-59,同时可用的特殊字符为 , – * /  例如”0  15  10 ?  *  6L”代表的意义就是每月最后一个星期五的10:15. 下面介绍一下特殊字符的含义:

2 常见的表达式

　　下面给出一些常见的Cron-Expressions示例:

0/1 * * * * ?

3 CronTrigger示例

　　由上面的常见表达式我们知道表达式 “0/1 * * * * ?”代表了每秒执行 , 其CronTrigger定义如下:

                 ITrigger trigger = TriggerBuilder.Create()
                .WithIdentity("cronTrigger1", "SimpleGroup")
                .WithCronSchedule("0/1 * * * * ?", x => x
                    .WithMisfireHandlingInstructionFireAndProceed())
                .ForJob("HelloJob", "SimpleGroup")
                .Build();

　　也可以用下面的方法进行定义(注意默认时间不是系统时间-北京时间,所以如果打印出Job第一次打印的时间不是正确的时间,但是好像不影响使用):

 //定义job
 IJobDetail job3 = JobBuilder.Create<ColorJob>()
 .WithIdentity("job3", "group1")
 .Build();
 //定义cronTrigger
 ICronTrigger cronTrigger = (ICronTrigger)TriggerBuilder.Create()
                              .WithIdentity("cronTrigger", "group1")
                               .WithCronSchedule("0/20 * * * * ?", x => x
                                         .InTimeZone(TimeZoneInfo.FindSystemTimeZoneById("China Standard Time")))//无效 ?
                              .Build();
 //默认开始时间
 DateTimeOffset scheduleTime3 = sched.ScheduleJob(job3, cronTrigger);
 //转换到本地时间(北京时间)
 DateTimeOffset dt=  scheduleTime3.ToLocalTime();//
 //北京时间为默认时间+8小时
 DateTimeOffset scheduleTimeChina = scheduleTime3.AddHours();
 //返回Cron Expression
 string cronExpression = cronTrigger.CronExpressionString;

　　　如果在定义的时间规则下,我想排除一些日期,那么如何实现呢?用ModifiedByCalendar即可实现:

         //排除的日期
            HolidayCalendar cal = new HolidayCalendar();
            DateTime dt排除 = new DateTime(, , );
            cal.AddExcludedDate(dt排除);            sched.AddCalendar("myHolidayCalendar", cal, false, true);
             //定义job
            IJobDetail job3 = JobBuilder.Create<ColorJob>()
             .WithIdentity("job3", "group1")
             .Build();
            //定义cronTrigger
            ICronTrigger cronTrigger = (ICronTrigger)TriggerBuilder.Create()
                                          .WithIdentity("cronTrigger", "group1")
                                           .WithCronSchedule("0/20 * * * * ?", x => x
                                                     .InTimeZone(TimeZoneInfo.FindSystemTimeZoneById("China Standard Time")))//无效 ?
                                          .ModifiedByCalendar("myHolidayCalendar")
                                          .Build();
            //默认开始时间
            DateTimeOffset scheduleTime3 = sched.ScheduleJob(job3, cronTrigger);
             //转换到本地时间(北京时间)
            //  2015-12-02 00:00:00 +08:00 不包含 2015-12-01
            DateTimeOffset dt = scheduleTime3.ToLocalTime();
             //北京时间为默认时间+8小时
            DateTimeOffset scheduleTimeChina = scheduleTime3.AddHours();
            //返回Cron Expression
            string cronExpression = cronTrigger.CronExpressionString;