快捷導(dǎo)航

spring 定時(shí)任務(wù)@Scheduled詳解

更新時(shí)間：2017年01月22日 08:40:34 作者：WhyWin

這篇文章主要介紹了spring 定時(shí)任務(wù)@Scheduled的相關(guān)資料，文中通過示例代碼介紹的很詳細(xì)，相信對(duì)大家的理解和學(xué)習(xí)具有一定的參考借鑒價(jià)值，有需要的朋友們下面來一起看看吧。

一、配置文件

<?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">

 <!-- 定時(shí)任務(wù)相關(guān)配置 -->
 <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>

二、調(diào)用

有兩種使用方式

1）如果需要以固定速率執(zhí)行，只要將注解中指定的屬性名稱改成fixedRate即可，以下方法將以一個(gè)固定速率5s來調(diào)用一次執(zhí)行，這個(gè)周期是以上一個(gè)任務(wù)開始時(shí)間為基準(zhǔn)，從上一任務(wù)開始執(zhí)行后5s再次調(diào)用：

@Scheduled(fixedDelay = 5000)
 public void testTask() {
  logger.info("測(cè)試定時(shí)任務(wù)");
 }

2）使用cron表達(dá)式，可以實(shí)現(xiàn)定時(shí)調(diào)用如：每天凌晨調(diào)用，詳細(xì)的cron相關(guān)參數(shù)見后面介紹

@Scheduled(cron = "cron = "0 0 2 * * ?"")
 public void testTaskWithDate() {
  logger.info("測(cè)試2016.定時(shí)任務(wù)");
 }

3、cron相關(guān)參數(shù)意義

一個(gè)cron表達(dá)式有至少6個(gè)（也可能7個(gè)）有空格分隔的時(shí)間元素。

按順序依次為

　　秒（0~59）
　　分鐘（0~59）
　　小時(shí)（0~23）
　　天（月）（0~31，但是你需要考慮你月的天數(shù)）
　　月（0~11）
　　天（星期）（1~7 1=SUN 或 SUN，MON，TUE，WED，THU，F(xiàn)RI，SAT）
　　年份（1970－2099）——@Scheduled是不支持的，spring quartz支持

其中每個(gè)元素可以是一個(gè)值(如6),一個(gè)連續(xù)區(qū)間(9-12),一個(gè)間隔時(shí)間(8-18/4)(/表示每隔4小時(shí)),一個(gè)列表(1,3,5),通配符。由于"月份中的日期"和"星期中的日期"這兩個(gè)元素互斥的,必須要對(duì)其中一個(gè)設(shè)置?.

　　0 0 10,14,16 * * ? 每天上午10點(diǎn)，下午2點(diǎn)，4點(diǎn)
　　0 0/30 9-17 * * ? 朝九晚五工作時(shí)間內(nèi)每半小時(shí)
　　0 0 12 ? * WED 表示每個(gè)星期三中午12點(diǎn)
　　"0 0 12 * * ?" 每天中午12點(diǎn)觸發(fā)
　　"0 15 10 ? * *" 每天上午10:15觸發(fā)
　　"0 15 10 * * ?" 每天上午10:15觸發(fā)
　　"0 15 10 * * ? *" 每天上午10:15觸發(fā)
　　"0 15 10 * * ? 2005" 2005年的每天上午10:15觸發(fā)
　　"0 * 14 * * ?" 在每天下午2點(diǎn)到下午2:59期間的每1分鐘觸發(fā)
　　"0 0/5 14 * * ?" 在每天下午2點(diǎn)到下午2:55期間的每5分鐘觸發(fā)
　　"0 0/5 14,18 * * ?" 在每天下午2點(diǎn)到2:55期間和下午6點(diǎn)到6:55期間的每5分鐘觸發(fā)
　　"0 0-5 14 * * ?" 在每天下午2點(diǎn)到下午2:05期間的每1分鐘觸發(fā)
　　"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44觸發(fā)
　　"0 15 10 ? * MON-FRI" 周一至周五的上午10:15觸發(fā)
　　"0 15 10 15 * ?" 每月15日上午10:15觸發(fā)
　　"0 15 10 L * ?" 每月最后一日的上午10:15觸發(fā)
　　"0 15 10 ? * 6L" 每月的最后一個(gè)星期五上午10:15觸發(fā)
　　"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最后一個(gè)星期五上午10:15觸發(fā)
　　"0 15 10 ? * 6#3" 每月的第三個(gè)星期五上午10:15觸發(fā)

有些子表達(dá)式能包含一些范圍或列表

　　例如：子表達(dá)式（天（星期））可以為 “MON-FRI”，“MON，WED，F(xiàn)RI”，“MON-WED,SAT”

　　“*”字符代表所有可能的值

　　因此，“*”在子表達(dá)式（月）里表示每個(gè)月的含義，“*”在子表達(dá)式（天（星期））表示星期的每一天

　　“/”字符用來指定數(shù)值的增量

　　例如：在子表達(dá)式（分鐘）里的“0/15”表示從第0分鐘開始，每15分鐘

在子表達(dá)式（分鐘）里的“3/20”表示從第3分鐘開始，每20分鐘（它和“3，23，43”）的含義一樣

　　“？”字符僅被用于天（月）和天（星期）兩個(gè)子表達(dá)式，表示不指定值

　　當(dāng)2個(gè)子表達(dá)式其中之一被指定了值以后，為了避免沖突，需要將另一個(gè)子表達(dá)式的值設(shè)為“？”

　　“L” 字符僅被用于天（月）和天（星期）兩個(gè)子表達(dá)式，它是單詞“l(fā)ast”的縮寫

　　但是它在兩個(gè)子表達(dá)式里的含義是不同的。

　　在天（月）子表達(dá)式中，“L”表示一個(gè)月的最后一天

　　在天（星期）自表達(dá)式中，“L”表示一個(gè)星期的最后一天，也就是SAT

　　如果在“L”前有具體的內(nèi)容，它就具有其他的含義了

　　例如：“6L”表示這個(gè)月的倒數(shù)第６天，“ＦＲＩＬ”表示這個(gè)月的最一個(gè)星期五

　　注意：在使用“L”參數(shù)時(shí)，不要指定列表或范圍，因?yàn)檫@會(huì)導(dǎo)致問題

字段	允許值	允許的特殊字符
秒	0-59	, - * /
分	0-59	, - * /
小時(shí)	0-23	, - * /
日期	1-31	, - * ? / L W C
月份	1-12 或者 JAN-DEC	, - * /
星期	1-7 或者 SUN-SAT	, - * ? / L C #
年（可選）	留空, 1970-2099	, - * /

4、局限性——@Scheduled的cron無法指定執(zhí)行的年份

即我們假如使用下面的定時(shí)任務(wù)

@Scheduled(cron = "0 18 10 * * ? 2016-2016")
  public void testTaskWithDate() {
    logger.info("測(cè)試2016.定時(shí)任務(wù)");
  }

將會(huì)報(bào)下面的錯(cuò)誤

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

錯(cuò)誤原因：

/**
 * 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 不支持年位定時(shí),它畢竟不是quartz,只是簡(jiǎn)單的定時(shí)框架,比起jdk Timer就加入了線程池而以.

但是制定到年份，會(huì)存在一個(gè)問題，就是在你在過了這個(gè)時(shí)間后再啟動(dòng)項(xiàng)目的時(shí)候，他會(huì)一直報(bào)一個(gè)memory leak的錯(cuò)誤，大概的意思是你的定時(shí)任務(wù)將永遠(yuǎn)不會(huì)被執(zhí)行，導(dǎo)致項(xiàng)目一直啟動(dòng)不了。

源碼里的注釋:

*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.

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作能帶來一定的幫助，如果有疑問大家可以留言交流。

您可能感興趣的文章: