spring 定时任务@Scheduled详解

2024-03-04 15:47:04 151

一、配置文件

<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="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/beanshttp://www.springframework.org/schema/beans/spring-beans-4.1.xsd
http://www.springframework.org/schema/taskhttp://www.springframework.org/schema/task/spring-task.xsd"
default-autowire="byName"default-lazy-init="false">

<!--定时任务相关配置-->
<task:executorid="executor"pool-size="10"queue-capacity="128"/>
<task:schedulerid="scheduler"pool-size="10"/>
<task:annotation-drivenexecutor="executor"scheduler="scheduler"proxy-target-class="true"/>

</beans>

二、调用

有两种使用方式

1）如果需要以固定速率执行，只要将注解中指定的属性名称改成fixedRate即可，以下方法将以一个固定速率5s来调用一次执行，这个周期是以上一个任务开始时间为基准，从上一任务开始执行后5s再次调用：

@Scheduled(fixedDelay=5000)
publicvoidtestTask(){
logger.info("测试定时任务");
}

2）使用cron表达式，可以实现定时调用如：每天凌晨调用，详细的cron相关参数见后面介绍

@Scheduled(cron="cron="002**?"")
publicvoidtestTaskWithDate(){
logger.info("测试2016.定时任务");
}

3、cron相关参数意义

一个cron表达式有至少6个（也可能7个）有空格分隔的时间元素。

按顺序依次为

秒（0~59）
分钟（0~59）
小时（0~23）
天（月）（0~31，但是你需要考虑你月的天数）
月（0~11）
天（星期）（1~71=SUN或SUN，MON，TUE，WED，THU，FRI，SAT）
年份（1970－2099）——@Scheduled是不支持的，springquartz支持

其中每个元素可以是一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/表示每隔4小时),一个列表(1,3,5),通配符。由于"月份中的日期"和"星期中的日期"这两个元素互斥的,必须要对其中一个设置?.

0010,14,16**?每天上午10点，下午2点，4点
00/309-17**? 朝九晚五工作时间内每半小时
0012?*WED表示每个星期三中午12点
"0012**?"每天中午12点触发
"01510?**"每天上午10:15触发
"01510**?"每天上午10:15触发
"01510**?*"每天上午10:15触发
"01510**?2005"2005年的每天上午10:15触发
"0*14**?"在每天下午2点到下午2:59期间的每1分钟触发
"00/514**?"在每天下午2点到下午2:55期间的每5分钟触发
"00/514,18**?"在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
"00-514**?"在每天下午2点到下午2:05期间的每1分钟触发
"010,4414?3WED"每年三月的星期三的下午2:10和2:44触发
"01510?*MON-FRI"周一至周五的上午10:15触发
"0151015*?"每月15日上午10:15触发
"01510L*?"每月最后一日的上午10:15触发
"01510?*6L"每月的最后一个星期五上午10:15触发
"01510?*6L2002-2005"2002年至2005年的每月的最后一个星期五上午10:15触发
"01510?*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 ,-*?/LWC 月份 1-12 或者JAN-DEC ,-*/ 星期 1-7 或者SUN-SAT ,-*?/LC# 年（可选）留空,1970-2099 ,-*/

4、局限性——@Scheduled的cron无法指定执行的年份

即我们假如使用下面的定时任务

@Scheduled(cron="01810**?2016-2016")
publicvoidtestTaskWithDate(){
logger.info("测试2016.定时任务");
}

将会报下面的错误

Cronexpressionmustconsistof6fields(found7in"01810**?2016-2016")

org.springframework.beans.factory.BeanCreationException:Errorcreatingbeanwithname'giftReceiveRecordServiceImp'definedinURL[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]:Initializationofbeanfailed;nestedexceptionisjava.lang.IllegalStateException:Encounteredinvalid@Scheduledmethod'testTaskWithDate':Cronexpressionmustconsistof6fields(found7in"01810**?2016-2016")
atorg.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:553)
atorg.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:482)
atorg.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:306)
atorg.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:230)
atorg.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:302)
atorg.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:197)
atorg.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:772)
atorg.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:839)
atorg.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:538)
atorg.springframework.web.context.ContextLoader.configureAndRefreshWebApplicationContext(ContextLoader.java:444)
atorg.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:326)
atorg.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:107)
atorg.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:4842)
atorg.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5303)
atorg.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:147)
atorg.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:725)
atorg.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:701)
atorg.apache.catalina.core.StandardHost.addChild(StandardHost.java:717)
atorg.apache.catalina.startup.HostConfig.manageApp(HostConfig.java:1696)
atsun.reflect.NativeMethodAccessorImpl.invoke0(NativeMethod)
atsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
atsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
atjava.lang.reflect.Method.invoke(Method.java:606)
atorg.apache.tomcat.util.modeler.BaseModelMBean.invoke(BaseModelMBean.java:300)
atcom.sun.jmx.interceptor.DefaultMBeanServerInterceptor.invoke(DefaultMBeanServerInterceptor.java:819)
atcom.sun.jmx.mbeanserver.JmxMBeanServer.invoke(JmxMBeanServer.java:801)
atorg.apache.catalina.mbeans.MBeanFactory.createStandardContext(MBeanFactory.java:484)
atorg.apache.catalina.mbeans.MBeanFactory.createStandardContext(MBeanFactory.java:433)
atsun.reflect.NativeMethodAccessorImpl.invoke0(NativeMethod)
atsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
atsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
atjava.lang.reflect.Method.invoke(Method.java:606)
atorg.apache.tomcat.util.modeler.BaseModelMBean.invoke(BaseModelMBean.java:300)
atcom.sun.jmx.interceptor.DefaultMBeanServerInterceptor.invoke(DefaultMBeanServerInterceptor.java:819)
atcom.sun.jmx.mbeanserver.JmxMBeanServer.invoke(JmxMBeanServer.java:801)
atjavax.management.remote.rmi.RMIConnectionImpl.doOperation(RMIConnectionImpl.java:1487)
atjavax.management.remote.rmi.RMIConnectionImpl.access$300(RMIConnectionImpl.java:97)
atjavax.management.remote.rmi.RMIConnectionImpl$PrivilegedOperation.run(RMIConnectionImpl.java:1328)
atjavax.management.remote.rmi.RMIConnectionImpl.doPrivilegedOperation(RMIConnectionImpl.java:1420)
atjavax.management.remote.rmi.RMIConnectionImpl.invoke(RMIConnectionImpl.java:848)
atsun.reflect.NativeMethodAccessorImpl.invoke0(NativeMethod)
atsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
atsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
atjava.lang.reflect.Method.invoke(Method.java:606)
atsun.rmi.server.UnicastServerRef.dispatch(UnicastServerRef.java:322)
atsun.rmi.transport.Transport$2.run(Transport.java:202)
atsun.rmi.transport.Transport$2.run(Transport.java:199)
atjava.security.AccessController.doPrivileged(NativeMethod)
atsun.rmi.transport.Transport.serviceCall(Transport.java:198)
atsun.rmi.transport.tcp.TCPTransport.handleMessages(TCPTransport.java:567)
atsun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run0(TCPTransport.java:828)
atsun.rmi.transport.tcp.TCPTransport$ConnectionHandler.access$400(TCPTransport.java:619)
atsun.rmi.transport.tcp.TCPTransport$ConnectionHandler$1.run(TCPTransport.java:684)
atsun.rmi.transport.tcp.TCPTransport$ConnectionHandler$1.run(TCPTransport.java:681)
atjava.security.AccessController.doPrivileged(NativeMethod)
atsun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run(TCPTransport.java:681)
atjava.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
atjava.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
atjava.lang.Thread.run(Thread.java:745)
Causedby:java.lang.IllegalStateException:Encounteredinvalid@Scheduledmethod'testTaskWithDate':Cronexpressionmustconsistof6fields(found7in"01810**?2016-2016")
atorg.springframework.scheduling.annotation.ScheduledAnnotationBeanPostProcessor.processScheduled(ScheduledAnnotationBeanPostProcessor.java:405)
atorg.springframework.scheduling.annotation.ScheduledAnnotationBeanPostProcessor.postProcessAfterInitialization(ScheduledAnnotationBeanPostProcessor.java:258)
atorg.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.applyBeanPostProcessorsAfterInitialization(AbstractAutowireCapableBeanFactory.java:422)
atorg.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1583)
atorg.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:545)
...58more

错误原因：

/**
*Parsethegivenpatternexpression.
*/
privatevoidparse(Stringexpression)throwsIllegalArgumentException{
String[]fields=StringUtils.tokenizeToStringArray(expression,"");
if(fields.length!=6){
thrownewIllegalArgumentException(String.format(""
+"cronexpressionmustconsistof6fields(found%din%s)",fields.length,expression));
}

springtaks不支持年位定时,它毕竟不是quartz,只是简单的定时框架,比起jdkTimer就加入了线程池而以.

但是制定到年份，会存在一个问题，就是在你在过了这个时间后再启动项目的时候，他会一直报一个memoryleak的错误，大概的意思是你的定时任务将永远不会被执行，导致项目一直启动不了。

源码里的注释:

*Thepatternisalistofsixsinglespace-separatedfields:representing
*second,minute,hour,day,month,weekday.Monthandweekdaynamescanbe
*givenasthefirstthreelettersoftheEnglishnames.

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流。

spring 定时任务@Scheduled详解

热门推荐

随机推荐