spring 定时任务@Scheduled详解
程序员文章站
2024-03-08 16:43:11
一、配置文件
一、配置文件
<?xml version="1.0" encoding="utf-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:task="http://www.springframework.org/schema/task" xsi:schemalocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.1.xsd http://www.springframework.org/schema/task http://www.springframework.org/schema/task/spring-task.xsd" default-autowire="byname" default-lazy-init="false"> <!-- 定时任务相关配置 --> <task:executor id="executor" pool-size="10" queue-capacity="128"/> <task:scheduler id="scheduler" pool-size="10"/> <task:annotation-driven executor="executor" scheduler="scheduler" proxy-target-class="true"/> </beans>
二、调用
有两种使用方式
1）如果需要以固定速率执行，只要将注解中指定的属性名称改成fixedrate即可，以下方法将以一个固定速率5s来调用一次执行，这个周期是以上一个任务开始时间为基准，从上一任务开始执行后5s再次调用：
@scheduled(fixeddelay = 5000)
public void testtask() {
logger.info("测试定时任务");
}
2）使用cron表达式，可以实现定时调用如：每天凌晨调用，详细的cron相关参数见后面介绍
@scheduled(cron = "cron = "0 0 2 * * ?"")
public void testtaskwithdate() {
logger.info("测试2016.定时任务");
}
3、cron相关参数意义
一个cron表达式有至少6个（也可能7个）有空格分隔的时间元素。
按顺序依次为
- 秒（0~59）
- 分钟（0~59）
- 小时（0~23）
- 天（月）（0~31，但是你需要考虑你月的天数）
- 月（0~11）
- 天（星期）（1~7 1=sun 或 sun，mon，tue，wed，thu，fri，sat）
- 年份（1970－2099）——@scheduled是不支持的，spring quartz支持
其中每个元素可以是一个值(如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点
- "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期间的每1分钟触发
- "0 0/5 14 * * ?" 在每天下午2点到下午2:55期间的每5分钟触发
- "0 0/5 14,18 * * ?" 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
- "0 0-5 14 * * ?" 在每天下午2点到下午2:05期间的每1分钟触发
- "0 10,44 14 ? 3 wed" 每年三月的星期三的下午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" 每月的第三个星期五上午10:15触发
有些子表达式能包含一些范围或列表
例如：子表达式（天（星期））可以为 “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”表示这个月的倒数第６天，“ｆｒｉｌ”表示这个月的最一个星期五
注意：在使用“l”参数时，不要指定列表或范围，因为这会导致问题
| 字段 | 允许值 | 允许的特殊字符 |
| 秒 | 0-59 | , - * / |
| 分 | 0-59 | , - * / |
| 小时 | 0-23 | , - * / |
| 日期 | 1-31 | , - * ? / l w c |
| 月份 | 1-12 或者 jan-dec | , - * / |
| 星期 | 1-7 或者 sun-sat | , - * ? / l c # |
| 年（可选） | 留空, 1970-2099 | , - * / |
4、局限性——@scheduled的cron无法指定执行的年份
即我们假如使用下面的定时任务
@scheduled(cron = "0 18 10 * * ? 2016-2016")
public void testtaskwithdate() {
logger.info("测试2016.定时任务");
}
将会报下面的错误
cron expression must consist of 6 fields (found 7 in "0 18 10 * * ? 2016-2016")
org.springframework.beans.factory.beancreationexception: error creating bean with name 'giftreceiverecordserviceimp' defined in url [jar:file:/users/zhengcanrui/work/git/seewoedu-train-server/train-web/target/train/web-inf/lib/train-server-2.0-snapshot.jar!/com/seewoedu/train/service/impl/giftreceiverecordserviceimp.class]: initialization of bean failed; nested exception is java.lang.illegalstateexception: encountered invalid @scheduled method 'testtaskwithdate': cron expression must consist of 6 fields (found 7 in "0 18 10 * * ? 2016-2016") at org.springframework.beans.factory.support.abstractautowirecapablebeanfactory.docreatebean(abstractautowirecapablebeanfactory.java:553) at org.springframework.beans.factory.support.abstractautowirecapablebeanfactory.createbean(abstractautowirecapablebeanfactory.java:482) at org.springframework.beans.factory.support.abstractbeanfactory$1.getobject(abstractbeanfactory.java:306) at org.springframework.beans.factory.support.defaultsingletonbeanregistry.getsingleton(defaultsingletonbeanregistry.java:230) at org.springframework.beans.factory.support.abstractbeanfactory.dogetbean(abstractbeanfactory.java:302) at org.springframework.beans.factory.support.abstractbeanfactory.getbean(abstractbeanfactory.java:197) at org.springframework.beans.factory.support.defaultlistablebeanfactory.preinstantiatesingletons(defaultlistablebeanfactory.java:772) at org.springframework.context.support.abstractapplicationcontext.finishbeanfactoryinitialization(abstractapplicationcontext.java:839) at org.springframework.context.support.abstractapplicationcontext.refresh(abstractapplicationcontext.java:538) at org.springframework.web.context.contextloader.configureandrefreshwebapplicationcontext(contextloader.java:444) at org.springframework.web.context.contextloader.initwebapplicationcontext(contextloader.java:326) at org.springframework.web.context.contextloaderlistener.contextinitialized(contextloaderlistener.java:107) at org.apache.catalina.core.standardcontext.listenerstart(standardcontext.java:4842) at org.apache.catalina.core.standardcontext.startinternal(standardcontext.java:5303) at org.apache.catalina.util.lifecyclebase.start(lifecyclebase.java:147) at org.apache.catalina.core.containerbase.addchildinternal(containerbase.java:725) at org.apache.catalina.core.containerbase.addchild(containerbase.java:701) at org.apache.catalina.core.standardhost.addchild(standardhost.java:717) at org.apache.catalina.startup.hostconfig.manageapp(hostconfig.java:1696) at sun.reflect.nativemethodaccessorimpl.invoke0(native method) at sun.reflect.nativemethodaccessorimpl.invoke(nativemethodaccessorimpl.java:57) at sun.reflect.delegatingmethodaccessorimpl.invoke(delegatingmethodaccessorimpl.java:43) at java.lang.reflect.method.invoke(method.java:606) at org.apache.tomcat.util.modeler.basemodelmbean.invoke(basemodelmbean.java:300) at com.sun.jmx.interceptor.defaultmbeanserverinterceptor.invoke(defaultmbeanserverinterceptor.java:819) at com.sun.jmx.mbeanserver.jmxmbeanserver.invoke(jmxmbeanserver.java:801) at org.apache.catalina.mbeans.mbeanfactory.createstandardcontext(mbeanfactory.java:484) at org.apache.catalina.mbeans.mbeanfactory.createstandardcontext(mbeanfactory.java:433) at sun.reflect.nativemethodaccessorimpl.invoke0(native method) at sun.reflect.nativemethodaccessorimpl.invoke(nativemethodaccessorimpl.java:57) at sun.reflect.delegatingmethodaccessorimpl.invoke(delegatingmethodaccessorimpl.java:43) at java.lang.reflect.method.invoke(method.java:606) at org.apache.tomcat.util.modeler.basemodelmbean.invoke(basemodelmbean.java:300) at com.sun.jmx.interceptor.defaultmbeanserverinterceptor.invoke(defaultmbeanserverinterceptor.java:819) at com.sun.jmx.mbeanserver.jmxmbeanserver.invoke(jmxmbeanserver.java:801) at javax.management.remote.rmi.rmiconnectionimpl.dooperation(rmiconnectionimpl.java:1487) at javax.management.remote.rmi.rmiconnectionimpl.access$300(rmiconnectionimpl.java:97) at javax.management.remote.rmi.rmiconnectionimpl$privilegedoperation.run(rmiconnectionimpl.java:1328) at javax.management.remote.rmi.rmiconnectionimpl.doprivilegedoperation(rmiconnectionimpl.java:1420) at javax.management.remote.rmi.rmiconnectionimpl.invoke(rmiconnectionimpl.java:848) at sun.reflect.nativemethodaccessorimpl.invoke0(native method) at sun.reflect.nativemethodaccessorimpl.invoke(nativemethodaccessorimpl.java:57) at sun.reflect.delegatingmethodaccessorimpl.invoke(delegatingmethodaccessorimpl.java:43) at java.lang.reflect.method.invoke(method.java:606) at sun.rmi.server.unicastserverref.dispatch(unicastserverref.java:322) at sun.rmi.transport.transport$2.run(transport.java:202) at sun.rmi.transport.transport$2.run(transport.java:199) at java.security.accesscontroller.doprivileged(native method) at sun.rmi.transport.transport.servicecall(transport.java:198) at sun.rmi.transport.tcp.tcptransport.handlemessages(tcptransport.java:567) at sun.rmi.transport.tcp.tcptransport$connectionhandler.run0(tcptransport.java:828) at sun.rmi.transport.tcp.tcptransport$connectionhandler.access$400(tcptransport.java:619) at sun.rmi.transport.tcp.tcptransport$connectionhandler$1.run(tcptransport.java:684) at sun.rmi.transport.tcp.tcptransport$connectionhandler$1.run(tcptransport.java:681) at java.security.accesscontroller.doprivileged(native method) at sun.rmi.transport.tcp.tcptransport$connectionhandler.run(tcptransport.java:681) at java.util.concurrent.threadpoolexecutor.runworker(threadpoolexecutor.java:1145) at java.util.concurrent.threadpoolexecutor$worker.run(threadpoolexecutor.java:615) at java.lang.thread.run(thread.java:745) caused by: java.lang.illegalstateexception: encountered invalid @scheduled method 'testtaskwithdate': cron expression must consist of 6 fields (found 7 in "0 18 10 * * ? 2016-2016") at org.springframework.scheduling.annotation.scheduledannotationbeanpostprocessor.processscheduled(scheduledannotationbeanpostprocessor.java:405) at org.springframework.scheduling.annotation.scheduledannotationbeanpostprocessor.postprocessafterinitialization(scheduledannotationbeanpostprocessor.java:258) at org.springframework.beans.factory.support.abstractautowirecapablebeanfactory.applybeanpostprocessorsafterinitialization(abstractautowirecapablebeanfactory.java:422) at org.springframework.beans.factory.support.abstractautowirecapablebeanfactory.initializebean(abstractautowirecapablebeanfactory.java:1583) at org.springframework.beans.factory.support.abstractautowirecapablebeanfactory.docreatebean(abstractautowirecapablebeanfactory.java:545) ... 58 more
错误原因：
/**
* parse the given pattern expression.
*/
private void parse(string expression) throws illegalargumentexception {
string[] fields = stringutils.tokenizetostringarray(expression, " ");
if (fields.length != 6) {
throw new illegalargumentexception(string.format(""
+ "cron expression must consist of 6 fields (found %d in %s)", fields.length, expression));
}
spring taks 不支持年位定时,它毕竟不是quartz,只是简单的定时框架,比起jdk timer就加入了线程池而以.
但是制定到年份，会存在一个问题，就是在你在过了这个时间后再启动项目的时候，他会一直报一个memory leak的错误，大概的意思是你的定时任务将永远不会被执行，导致项目一直启动不了。
源码里的注释:
*the pattern is a list of six single space-separated fields: representing
* second, minute, hour, day, month, weekday. month and weekday names can be
* given as the first three letters of the english names.
总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流。