注解配置定时任务——@Scheduled

Java中注解@Scheduled 的注解代码如下：

@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Repeatable(Schedules.class)
public @interface Scheduled {
    String cron() default "";

    String zone() default "";

    long fixedDelay() default -1L;

    String fixedDelayString() default "";

    long fixedRate() default -1L;

    String fixedRateString() default "";

    long initialDelay() default -1L;

    String initialDelayString() default "";
}

可以看出，在选择@Scheduled（xx,xx,xx）的时候，会有多种的选择，这边就简单介绍常用的用法。

1、cron 这点Scheduled跟Quartz还是有点默契的，都可以用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）

其中每个元素可以是一个值(如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 　　　　 , - * /

2、默认使用服务器默认时区

可以设置为java.util.TimeZone中的zoneId

3、fixedDelay

fixedDelay 指的是在服务启动的时候会执行一次，以后每xx次执行一次

fixedDelay=5000

4、fixedDelayString

fixedDelay 的字符串 String格式

5、initialDelay

任务首次执行的延迟，即服务启动之后间隔指定时间执行首次

6、 initialDelayString

initialDelay 的字符串 String格式

具体的代码示例：

@Configuration
@EnableScheduling
public class TaskTest {

    @Scheduled(fixedDelay = 5000)
    public void task() {
        System.out.println("每五秒输出一次！");
    }

    @Scheduled(cron = "*/10 * * * * ?")
    public void task2() {
        System.out.println("每十秒输出一次！");
    }
}

参考：http://biaoming.iteye.com/blog/39532

posted @ 2017-06-30 15:59 大园子阅读(2841) 评论(0) 编辑收藏举报

刷新页面返回顶部

注解配置定时任务——@Scheduled

公告