spring定时任务注解@Scheduled的记录

spring 定时任务@Scheduled

 

转自https://www.cnblogs.com/0201zcr/p/5995779.html

1、配置文件

复制代码
<?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>
复制代码

 2、调用

  有两种使用方式

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”表示这个月的倒数第6天,“FRIL”表示这个月的最一个星期五

  注意:在使用“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")
 View Code

错误原因:

复制代码
/**
 * 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.

   致谢:感谢您的阅读!

posted @ 2018-12-27 17:11  CN-无忧  阅读(480)  评论(0编辑  收藏  举报