Spring Boot 中的 @Scheduled 定时任务以及开关控制

Scheduled注解是Spring框架(包括Spring Boot)中用于实现定时任务的一种方式。以下是对Scheduled注解的详细解析:

一、基本概念

Scheduled注解允许开发者在Spring容器中定义定时任务。通过简单地在一个方法上添加Scheduled注解,Spring容器就会自动将这个方法配置为一个定时任务。这种方式不仅简化了定时任务的创建,还使得定时任务的管理变得更加灵活和可维护。

二、使用方式

Scheduled注解支持多种配置选项,包括执行计划、固定延迟、固定速率等。以下是一些常见的使用方式:

  1. 固定速率执行 :使用fixedRate属性指定任务执行的固定速率(以毫秒为单位)。例如,@Scheduled(fixedRate=5000)表示任务将每5秒执行一次。
  2. 固定延迟执行 :使用fixedDelay属性指定任务在上一次执行完成后等待的固定延迟时间(以毫秒为单位)。例如,@Scheduled(fixedDelay=5000)表示任务将在上一次执行完成后5秒再次执行。
  3. Cron表达式 :使用cron属性指定一个cron表达式来定义任务的执行计划。Cron表达式是一个字符串,由6或7个空格隔开的域组成,每个域代表一个时间单位(秒、分、时、日、月、周、年,其中年可选)。例如,@Scheduled(cron="0 0 12 * * ?")表示任务将在每天的中午12点执行。

三、注意事项

  1. @EnableScheduling注解 :要使Scheduled注解生效,需要在配置类上添加@EnableScheduling注解。这个注解会开启Spring的定时任务支持,并注册一个ScheduledAnnotationBeanPostProcessor实例来解析和处理带有Scheduled注解的方法。
  2. 线程池 :在Spring Boot中,所有通过Scheduled注解定义的定时任务都会被放入一个公用的线程池中执行。默认情况下,该线程池的并发线程数为1,即所有的任务会使用同一个线程被依次执行。如果需要并行执行多个任务,可以通过配置spring.task.scheduling.pool.size属性来增加线程池的大小。
  3. 任务执行时间:如果任务执行时间超过间隔时间(对于fixedRate)或延迟时间(对于fixedDelay),Spring将尽可能地安排下一次执行。但是,这可能会导致任务的实际执行时间与预期有所偏差。因此,建议尽量保证任务能够在较短的时间内执行完毕。
  4. 异常处理:在实际部署时,需要考虑任务执行时的异常处理和日志记录。如果任务在执行过程中抛出异常,可能会影响后续任务的执行。因此,建议添加适当的异常处理逻辑来捕获和处理可能出现的异常。

四、示例代码

以下是一个使用Scheduled注解创建定时任务的示例代码:

复制代码
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
public class ScheduledTasks {

    @Scheduled(fixedRate = 5000)
    public void reportCurrentTime() {
        System.out.println("The current time is: " + new java.util.Date());
    }
}

// 配置类
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableScheduling;

@Configuration
@EnableScheduling
public class SchedulerConfig implements SchedulingConfigurer {
    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
        taskScheduler.setPoolSize(Runtime.getRuntime().availableProcessors() * 2 + 10); 
        taskScheduler.initialize();
        taskRegistrar.setTaskScheduler(taskScheduler);
    }
}

在这个示例中,ScheduledTasks类中的reportCurrentTime方法被标记为一个定时任务,每5秒执行一次并打印当前时间。同时,在配置类SchedulingConfig上添加了@EnableScheduling注解来开启定时任务支持。

综上所述,Scheduled注解是Spring框架中用于实现定时任务的一种方便且强大的方式。通过合理配置和使用Scheduled注解,可以轻松地创建和管理各种定时任务以满足不同的业务需求。

五、开关控制定时任务

配置

复制代码
jobs:
  corn:
    enable: true
    testTask: "0 0/5 * * * ?"

定时任务

复制代码
@ConditionalOnProperty(prefix = "jobs.corn", name = "enable", havingValue = "true")
@Component
@Slf4j
public class TestTask {

    @Autowired
    TrainingJobService trainingJobService;

    @Scheduled(cron = "${jobs.corn.testTask:0/15 * * * * ?}")
    public void test() {
        log.info("TestTask test start");
        
    }


}
相关推荐
桦说编程几秒前
交替打印最容易理解的实现——同步队列
java·后端·设计模式
踏过山河,踏过海24 分钟前
Django自带的加密算法
数据库·django·sqlite
土族程序员24 分钟前
JavaFX CSS @font-face 错误全面分析 loadStylesheetUnPrivileged / reportException
java·css·javafx
猿小蔡-Cool32 分钟前
Android Studio Memory Monitor内存分析核心指标详解
android·java·jvm
刘火锅42 分钟前
解决IDEA拉取GitLab项目报错:必须为访问令牌授予作用域[api, read user]
java·gitlab·intellij-idea
黑白极客1 小时前
如何判断一个数据库是不是出问题了?
数据库·mysql
巴厘猫1 小时前
Java开发者新机遇:LangChain4j——在Java中构建LLM应用的利器
java·后端·langchain
逐梦设计1 小时前
基于SpringBoot教师听评课管理系统的设计与实现(毕业设计源码+开题报告+论文+系统部署讲解+答辩指导)
spring boot
不辉放弃1 小时前
Spark的累加器(Accumulator)
大数据·数据库·spark