SpringBoot 定时任务：@Scheduled

SpringBoot 定时任务：@Scheduled

在SpringBoot有自带的定时任务注解@Scheduled。@Scheduled可以通过注解配置快速实现方法的定时调度，直接在方法加上@Scheduled注解即可。

单线程定时任务

@Scheduled注解参数

1.cron参数

这个参数是最经常使用的参数，表示接收一个cron参数，cron它是一个表达式，最多接收7个参数，从左到右分别表示：秒 分 时 天 月 周 年；参数以空格隔开，其中年不是必须参数，可以省略。

@EnableScheduling   // 1.开启定时任务
public class SaticScheduleTask {
    //2.添加定时任务
	/** 
	* cron 一共可以有7个参数 以空格分开 其中年不是必须参数 
	* [秒] [分] [小时] [日] [月] [周] [年] 
	* 一下表示 
	*/
    @Scheduled(cron = "0/5 * * * * ?")
    //或直接指定时间间隔，例如：5秒
    //@Scheduled(fixedRate=5000)
	public void testScheduledCron(){
		//任务代码
	}
}

::: primary 注意！！！
在使用时需要在类上添加注解@EnableScheduling，表示开启定时任务。
:::

cron参数意义：

常用通配符：

• *：表示所有值 比如用在日 表示每一天。
• ?：表示不指定值 比如周配置 表示不指定星期几执行。
• /：表示递增触发 比如 用在分 5/20 从第五分钟开始 每增加20分钟执行一次。
• -：表示区间 比如用在 1-6 表示一月到六月执行。

示例：
每天凌晨零点执行

@Scheduled(cron ="0 0 0 * * * ?")

每隔五分钟执行

@Scheduled(cron ="0 */5 0 * * * ?")

2.zone参数

zone能够指定获取的时区，默认是空，表示使用服务器所在时区，比如Asia/BeiJingi或者Asia/Shanghai。

3.fixedDelay

fixedDelay表示上次调用结束后与下次调用之间的固定时间，单位是毫秒。

@Scheduled(fixedDelay= 3000)

表示距离上次调用后三秒再执行

4.fixedDelayString

fixedDelayString与fixedDelay是几乎一样的，唯一的差异是fixedDelayString是支持占位符的。

5.fixedRate

fixedRate表示多久执行一次，单位是毫秒。与cron的/通配符用法相似；

@Scheduled(fixedRate= 3000)

表示每三秒执行一次

6.fixedRateString

fixedRate的升级，支持占位符

7.initialDelay

表示第一次延迟多少毫秒执行，单位是毫秒

@Scheduled(initialDelay= 3000)

表示第一次执行时，延迟3秒执行

8.initialDelayString

initialDelay的升级，支持占位符。

多线程定时任务

基于注解设定多线程定时任务

/**
 * 多线程定时任务
 */
@EnableScheduling   // 1.开启定时任务
@EnableAsync        // 2.开启多线程
@Service            // 3.实现层注解
public class MultiThreadScheduleTask {
    @Async
    @Scheduled(fixedDelay = 10000)  //间隔1秒
    public void first() throws InterruptedException {
        System.out.println("第一个定时任务开始 : " + LocalDateTime.now().toLocalTime() + "\r\n线程 : " + Thread.currentThread().getName());
        System.out.println("定时任务测试:间隔10秒");
    }

    @Async
    @Scheduled(cron = "0 */1 * * * ?")  //间隔1分钟
    public void second() throws InterruptedException {
        System.out.println("第二个定时任务开始 : " + LocalDateTime.now().toLocalTime() + "\r\n线程 : " + Thread.currentThread().getName());
        System.out.println("定时任务测试：间隔1分钟");
    }
}

注意

@Scheduled使用时，是在本机进行任务调度，但是目前几乎所有的应用为了增加负载量，都是使用多机部署。这就导致了一个非常严重的分布式问题：在每一台机器上都会在同时执行定时调度任务，可能产生很多重复数据或者导致系统出现其他的业务逻辑BUG，所以在使用@Scheduled进行任务调度时，一定要配合redis的分布式锁来使用，让定时调度任务只在一台机器上执行，避免BUG出现。同时对于可能出现的失败任务一定要做好日志记录，方便排查和改错