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");
        
    }


}