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