3.2 定时任务
3.2.1配置
类定义前需要设置Component标注或Service标注,可让spring自动载入。类需要继承IEmapTask接口,用于标识这个类是一个定时调度任务的类。相关的方法上需要添加TaskScheduled标注,用于标识任务的调度时间表。注,执行任务的方法必须是无参的公有方法。如:
@Service("myBeanId")
public class MyClassName implements IEmapTask {
@TaskScheduled(cron="0 0/10 * * * ?")
public void myTask() {
…
}
}
任务默认为集群模式,如果任务需要在每个服务实例上都运行,需要将cluster设置为false。如:
@TaskScheduled(cron="0 0/10 * * * ?", cluster=false)
public void myTask() {
…
}
如果需要动态设置任务的调度时间,可用如下方式:
@TaskScheduled(methodCron="getCron")
public void myTask() {
…
}
public String getCron() {
return "0 0/10 * * * ?";
}
注1:cron和methodCron两项配置只能设置一个,不可同时设置。
注2:如果不需要执行定义任务(移除这个任务),getCron方法可返回null。
在运行过程中,如果需要刷新任务的调度时间,可使用TaskManager的如下方法:
TaskManager.resetTask("myBeanId", taskObj, "myTask ");
如果需要移除一个定时任务,可使用如下方法:
TaskManager.removeTask("myBeanId", MyClassName.class, "myTask ", true);
最后一个参数的值需要根据“@TaskScheduled”中cluster的值(默认为true)来设。
1.1.2CronExpression表达式
一个cron表达式有至少6个(也可能7个)有空格分隔的时间元素。按顺序依次为1.秒(0~59)2.分钟(0~59)3.小时(0~23)4.天(月)(0~31,但是你需要考虑你月的天数)5.月(0~11)6.天(星期)(1~7 1=SUN或SUN,MON,TUE,WED,THU,FRI,SAT)7.年份(1970-2099)
其中每个元素可以是一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/表示每隔4小时),一个列表(1,3,5),通配符。由于"月份中的日期"和"星期中的日期"这两个元素互斥的,必须要对其中一个设置?.
0 0 10,14,16 * * ?每天上午10点,下午2点,4点0 0/30 9-17 * * ???朝九晚五工作时间内每半小时0 0 12 ? * WED表示每个星期三中午12点
有些子表达式能包含一些范围或列表例如:子表达式(天(星期))可以为“MON-FRI”,“MON,WED,FRI”,“MON-WED,SAT”
“*”字符代表所有可能的值因此,“*”在子表达式(月)里表示每个月的含义,“*”在子表达式(天(星期))表示星期的每一天
“/”字符用来指定数值的增量例如:在子表达式(分钟)里的“0/15”表示从第0分钟开始,每15分钟;在子表达式(分钟)里的“3/20”表示从第3分钟开始,每20分钟(它和“3,23,43”)的含义一样“?”字符仅被用于天(月)和天(星期)两个子表达式,表示不指定值当2个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设为“?”
“L”字符仅被用于天(月)和天(星期)两个子表达式,它是单词“last”的缩写
但是它在两个子表达式里的含义是不同的。
在天(月)子表达式中,“L”表示一个月的最后一天,在天(星期)自表达式中,“L”表示一个星期的最后一天,也就是SAT
如果在“L”前有具体的内容,它就具有其他的含义了
例如:“6L”表示这个月的倒数第6天,“FRIL”表示这个月的最后一个星期五
注意:在使用“L”参数时,不要指定列表或范围,因为这会导致问题
============================================
CronTrigger配置完整格式为:[秒] [分] [小时] [日] [月] [周] [年]
序号说明是否必填允许填写的值允许的通配符
1秒是 0-59 , - * /
2分是 0-59 , - * /
3小时是 0-23 , - * /
4日是 1-31 , - * ? / L W
5月是 1-12 or JAN-DEC , - * /
6周是 1-7 or SUN-SAT , - * ? / L #
7年否 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",正好第五周没有周六,则不会触发该配置(用在母亲节和父亲节再合适不过了);小提示:'L'和'W'可以一组合使用。如果在日字段上设置"LW",则表示在本月的最后一个工作日触发;周字段的设置,若使用英文字母是不区分大小写的,即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,18 * * ?每天下午的2点到2点59分、18点到18点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天触发一次
0 11 11 11 11 ?每年的11月11号11点11分触发(光棍节)