CronTriggers

发表时间:2018-01-13 11:33:55 浏览量( 22 ) 留言数( 0 )

学习目标:

1、深入了解CronTrigger的设置

2、了解CronTrigger的超时策略


学习过程:

    如果你需要像日历那样按日程来触发任务,而不是像SimpleTrigger 那样每隔特定的间隔时间触发,  CronTriggers通常比SimpleTrigger更有用。  使用CronTrigger,你可以指定诸如“每个周五中午”,或者“每个工作日的9:30”或者“从每个周一、周三、周五的上午  9:00到上午10:00之间每隔五分钟”这样日程安排来触发。甚至,象SimpleTrigger一样,  CronTrigger也有一个StartTime以指定日程从什么时候开始,也有一个(可选的)EndTime以指定何时日程不再继续。  Cron表达式被用来配置CronTrigger实例。Cron表达式是一个由7个子表达式组成的字符串。

   如果你以前使用过Linux的cron就会知道这些语法的了。多看一下示例就可以了。

每个子表达式都描述了一个单独的日程细节。这些子表达式用空格分隔,分别表示: 

  1. Seconds 秒 

 2. Minutes 分钟 

 3. Hours 小时   

4. Day-of-Month 月中的天 

 5. Month 月  

 6. Day-of-Week 周中的天  

 7. Year (optional field) 年(可选的域)

格式: [秒] [分] [小时] [日] [月] [周] [年]

说明如下:

 是否必填 允许填写的值 

[秒] 允许填写的值是:0-59,允许的通配符是:- * /。

[分]允许填写的值是: 0-59- * /

[小时]允许填写的值是: 0-23 , - * /

[日] 允许填写的值是: 1-31 , - * ? / L W

[月] 允许填写的值是: 1-12 or JAN-DEC , - * /

[周] 允许填写的值是: 1-7 or SUN-SAT , - * ? / L #

[年] 允许填写的值是: empty 或 1970-2099 , - * /

通配符说明:

* 表示所有值. 例如:在分的字段上设置 "*",表示每一分钟都会触发。

? 表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作,但不关心是周几,所以需要周位置的那个字段设置为"?" 具体设置为 0 0 0 10 * ?。

- 表示区间。例如 在小时上设置 "10-12",表示 10,11,12点都会触发。

, 表示指定多个值,例如在周字段上设置 "MON,WED,FRI" 表示周一,周三和周五触发。

/ 用于递增触发。如在秒上面设置"5/15" 表示从5秒开始,每增15秒触发(5,20,35,50)。在月字段上设置'1/3'所示每月1号开始,每隔三天触发一次。

L 表示最后的意思。在日字段设置上,表示当月的最后一天(依据当前月份,如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六,相当于"7"或"SAT"。如果在"L"前加上数字,则表示该数据的最后一个。例如在周字段上设置"6L"这样的格式,则表示“本月最后一个星期五"。

W 表示离指定日期的最近那个工作日(周一至周五). 例如在日字段上设置"15W",表示离每月15号最近的那个工作日触发。如果15号正好是周六,则找最近的周五(14号)触发, 如果15号是周未,则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五),则就在该天触发。如果指定格式为 "1W",它则表示每月1号往后最近的工作日触发。如果1号正是周六,则将在3号下周一触发。(注,"W"前只能设置具体的数字,不允许区间"-")。

# 序号(表示每月的第几个周几),例如在周字段上设置"6#3"表示在每月的第三个周六.注意如果指定"#5",正好第五周没有周六,则不会触发该配置(用在母亲节和父亲节再合适不过了)。周字段的设置,若使用英文字母是不区分大小写的 MON 与mon相同。

在看看下面这些示例吧,应该大家就会写了。

0 0 12 * * ? 每天12点触发

0 15 10 ? * * 每天10点15分触发

0 15 10 * * ? 每天10点15分触发

0 15 10 * * ? * 每天10点15分触发

0 15 10 * * ? 2005 2005年每天10点15分触发

0 * 14 * * ? 每天下午的 2点到2点59分每分触发

0 0/5 14 * * ? 每天下午的 2点到2点59分(整点开始,每隔5分触发)

0 0-5 14 * * ? 每天下午的 2点到2点05分每分触发

0 10,44 14 ? 3 WED 3月分每周三下午的 2点10分和2点44分触发

0 15 10 ? * MON-FRI 从周一到周五每天上午的10点15分触发

0 15 10 15 * ? 每月15号上午10点15分触发

0 15 10 L * ? 每月最后一天的10点15分触发

0 15 10 ? * 6L 每月最后一周的星期五的10点15分触发

0 15 10 ? * 6L 2002-2005 从2002年到2005年每月最后一周的星期五的10点15分触发

0 15 10 ? * 6#3 每月的第三周的星期五开始触发

0 0 12 1/5 * ? 每月的第一个中午开始每隔5天触发一次


看一下下面的代码实例:

1、每天在8am ~ 5pm之间,每两分钟执行一次

			Trigger trigger =   newTrigger()
				    .withIdentity("trigger3", "group1")
				    .withSchedule(cronSchedule("0 0/2 8-17 * * ?"))
				    .forJob(job)
				    .build();

2、每天的 10:42 am触发:

  trigger = newTrigger()
    .withIdentity("trigger3", "group1")
    .withSchedule(dailyAtHourAndMinute(10, 42))
    .forJob(myJobKey)
    .build();
或者
  trigger = newTrigger()
    .withIdentity("trigger3", "group1")
    .withSchedule(cronSchedule("0 42 10 * * ?"))
    .forJob(myJobKey)
    .build();

3、每周三的10:42 am触发 

 trigger = newTrigger()
    .withIdentity("trigger3", "group1")
    .withSchedule(weeklyOnDayAndHourAndMinute(DateBuilder.WEDNESDAY, 10, 42))
    .forJob(myJobKey)
    .inTimeZone(TimeZone.getTimeZone("America/Los_Angeles"))
    .build();
或者
  trigger = newTrigger()
    .withIdentity("trigger3", "group1")
    .withSchedule(cronSchedule("0 42 10 ? * WED"))
    .inTimeZone(TimeZone.getTimeZone("America/Los_Angeles"))
    .forJob(myJobKey)
    .build();


2、超时策略

配置文件的配置。

    CronTrigger 的默认策略也是Trigger.MISFIRE_INSTRUCTION_SMART_POLICY 官方解释如下,也就是说不指定的话默认为:MISFIRE_INSTRUCTION_FIRE_ONCE_NOW。

1、MISFIRE_INSTRUCTION_FIRE_ONCE_NOW

    这个策略指示触发器超时后会被立即安排执行,也就是说不管这个触发器是否超过结束时间(endTime) 首选执行一次,然后就按照正常的计划执行。

2、MISFIRE_INSTRUCTION_DO_NOTHING

    这个策略与策略(1)正好相反,它不会被立即触发,而是获取下一个被触发的时间,并且如果下一个被触发的时间超出了end-time 那么触发器就不会被执行。