Spring定时任务(@Scheduled)

一、使用Spring的@Scheduled实现定时任务[1]

1、Spring配置文件xmlns加入

xmlns:task="http://www.springframework.org/schema/task"

xsi:schemaLocation中加入

     http://www.springframework.org/schema/task
     http://www.springframework.org/schema/task/spring-task-3.0.xsd"

2、spring扫描注解的配置

<context:component-scan base-package="com.imwoniu.*" />

3、任务扫描注解

<task:executor id="executor" pool-size="5" />  
<task:scheduler id="scheduler" pool-size="10" />  
<task:annotation-driven executor="executor" scheduler="scheduler" />

4、代码实现：

注解@Scheduled 可以作为一个触发源添加到一个方法中，例如，以下的方法将以一个固定延迟时间5秒钟调用一次执行，这个周期是以上一个调用任务的完成时间为基准，在上一个任务完成之后，5s后再次执行：

@Scheduled(fixedDelay = 5000)
public void doSomething() { 
    // something that should execute periodically
}

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

@Scheduled(fixedRate = 5000)
public void doSomething() { 
    // something that should execute periodically
}

 

如果简单的定期调度不能满足，那么cron表达式提供了可能

package com.imwoniu.task;

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
public class TaskDemo {
    
    @Scheduled(cron = "0 0 2 * * ?")　　//每天凌晨两点执行
        void doSomethingWith(){
            logger.info("定时任务开始......");
            long begin = System.currentTimeMillis();
        
            //执行数据库操作了哦...
        
            long end = System.currentTimeMillis();
            logger.info("定时任务结束，共耗时：[" + (end-begin) / 1000 + "]秒");
    }
}

以下内容摘自http://biaoming.iteye.com/blog/39532

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

按顺序依次为

秒（0~59）

分钟（0~59）

小时（0~23）

天（月）（0~31，但是你需要考虑你月的天数）

月（0~11）

天（星期）（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点 
"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		, - * /

==============================================================

二、spring定时任务详解（@Scheduled注解）[2]

在springMVC里使用spring的定时任务非常的简单，如下：

（一）在xml里加入task的命名空间

xmlns:task="http://www.springframework.org/schema/task"
http://www.springframework.org/schema/task http://www.springframework.org/schema/task/spring-task-4.1.xsd

（二）启用注解驱动的定时任务

<task:annotation-driven scheduler="myScheduler"/>

（三）配置定时任务的线程池

推荐配置线程池，若不配置多任务下会有问题。后面会详细说明单线程的问题。

<task:scheduler id="myScheduler" pool-size="5"/>

（四）写我们的定时任务

@Scheduled注解为定时任务，cron表达式里写执行的时机

package com.mvc.task.impl;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.concurrent.TimeUnit;
import org.joda.time.DateTime;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import com.mvc.task.IATask;
@Component
public class ATask implements IATask{
       @Scheduled(cron="0/10 * *  * * ? ")   //每10秒执行一次
       @Override
       public void aTask(){
            try {
                TimeUnit.SECONDS.sleep(20);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            DateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            System.out.println(sdf.format(DateTime.now().toDate())+"*********A任务每10秒执行一次进入测试");
       }
}

package com.mvc.task.impl;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import org.joda.time.DateTime;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import com.mvc.task.IBTask;
@Component
public class BTask implements IBTask{
       @Scheduled(cron="0/5 * *  * * ? ")   //每5秒执行一次
       @Override
       public void bTask(){
             DateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
             System.out.println(sdf.format(DateTime.now().toDate())+"*********B任务每5秒执行一次进入测试");
       }
}

spring的定时任务默认是单线程，多个任务执行起来时间会有问题（B任务会因为A任务执行起来需要20S而被延后20S执行），如下图所示：



当我们配置了线程池后再来看结果（多线程下，B任务再也不会因为A任务执行起来要20S而被延后了）：

cron表达式详解：    

一个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点
       "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”前有具体的内容，它就具有其他的含义了。例如：“6L”表示这个月的倒数第６天
       注意：在使用“L”参数时，不要指定列表或范围，因为这会导致问题
       W 字符代表着*日(Mon-Fri)，并且仅能用于日域中。它用来指定离指定日的最*的一个*日。大部分的商业处理都是基于工作周的，所以 W 字符可能是非常重要的。
       例如，日域中的 15W 意味着 "离该月15号的最*一个*日。" 假如15号是星期六，那么 trigger 会在14号(星期五)触发，因为星期四比星期一离15号更*。
       C：代表“Calendar”的意思。它的意思是计划所关联的日期，如果日期没有被关联，则相当于日历中所有日期。例如5C在日期字段中就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天。
       字段   允许值   允许的特殊字符
       秒           0-59           , - * /
       分           0-59           , - * /
       小时           0-23           , - * /
       日期           1-31           , - * ? / L W C
       月份           1-12 或者 JAN-DEC           , - * /
       星期           1-7 或者 SUN-SAT           , - * ? / L C #
       年（可选）           留空, 1970-2099           , - * /

原文出处：

[1] 愤怒的根号三, 使用Spring的@Scheduled实现定时任务, http://blog.csdn.net/prisonbreak_/article/details/49180307

[2] 李秀才, spring定时任务详解（@Scheduled注解）, http://blog.csdn.net/qq_33556185/article/details/51852537

Reference:

[1] biaoming, Quartz的cron表达式, http://biaoming.iteye.com/blog/39532