JAVA中@Scheduled注解定时任务执行使用

李建坤坤

于 2024-08-14 10:36:30 发布

阅读量975

点赞数 13

文章标签： java 开发语言

本文链接：https://blog.csdn.net/m0_48038376/article/details/141183958

版权

引入

想象一下，你有一个Spring应用，就像是一个大家庭，里面有各种各样的成员（也就是bean）。有时候，你想让某个成员定期做一些事情，比如每天早上起床后浇花。

在Spring里，@Scheduled注解就像是给这个成员贴了一张“定时任务”的标签。

首先，你需要告诉Spring，这个大家庭里有人要执行定时任务了。
这就是@EnableScheduling注解的作用，它就像是家庭里的“定时任务管理员”，负责管理和调度所有的定时任务。

然后，你给想要执行定时任务的成员（bean）的方法上贴上@Scheduled注解。
这个注解就像是一张任务清单，上面写着：“请在每天早上7点执行这个任务”。

Spring看到这个注解后，就会知道：“哦，这个成员想要在每天早上7点做这件事情啊，那我得帮他记下来。”
于是，Spring就会把这个任务添加到它的任务调度器里，这个调度器就像是家庭里的闹钟，会在指定的时间提醒成员执行任务。

到了第二天早上7点，闹钟响了，Spring就会告诉那个成员：“嘿，到你执行任务的时间了！”然后，那个成员就会起床去浇花了。

@Scheduled 注解的原理主要涉及 Spring 框架的任务调度机制，其核心是通过解析 @Scheduled 注解中的配置信息，将指定方法注册为定时任务，并在指定的时间或频率下执行。以下是 @Scheduled 注解原理的详细解析：

@Scheduled 注解是 Spring Framework 的一部分，用于声明一个方法应该被调度执行，即按照指定的时间规则自动执行。这是实现定时任务的一种简便方式。@Scheduled 注解可以应用于任何 Spring 管理的 bean 的方法上。

使用方式

要使用 @Scheduled 注解，首先需要在 Spring 配置中启用计划任务的执行。这可以通过在一个配置类上添加 @EnableScheduling 注解来实现。

@Configuration
@EnableScheduling
public class SchedulingConfig {
}

接下来，可以在任何 Spring bean 的方法上使用 @Scheduled 注解来声明这个方法应该按照特定的时间规则执行。

@Component
public class ScheduledTasks {

    @Scheduled(fixedRate = 5000)
    public void reportCurrentTime() {
        System.out.println("Current time is " + new Date());
    }
}

参数

@Scheduled 注解提供了多种参数来指定调度任务的执行规则：

fixedRate: 以固定频率执行任务，单位是毫秒。
fixedDelay: 上一个任务完成后，延迟指定时间执行，单位是毫秒。
cron: 使用 cron 表达式来定义任务执行的时间规则。

Cron 表达式

cron 表达式是一种强大的定时规则表达式，由六或七个空格分隔的时间字段组成。

秒（0-59）  分钟（0-59）  小时（0-23）  日期（1-31）  月份（1-12 或 JAN-DEC）  星期（1-7 或 SUN-SAT）  年份（可选）

例如，0 15 10 15 * ? 表示每月15日上午10:15执行。

注意事项

使用 @Scheduled 注解的方法应该有 void 返回类型，并且不能接受任何参数。
默认情况下，所有 @Scheduled 任务都将以单线程的方式执行。可以通过配置任务调度器来改变这一行为。
考虑到任务执行可能对系统性能的影响，合理安排任务的执行时间和频率是很重要的。

@Scheduled 注解提供了一种简单而强大的方式来处理 Spring 应用中的定时任务。通过合理使用，可以轻松实现各种复杂的调度需求。

原理

1. 启用定时任务支持

首先，需要在 Spring 配置中启用定时任务的支持。这通常通过在配置类上添加 @EnableScheduling 注解来实现。@EnableScheduling 注解会导入 SchedulingConfiguration 配置类，该类负责注册 ScheduledAnnotationBeanPostProcessor，这是一个 BeanPostProcessor 的实现，用于处理带有 @Scheduled 注解的方法。

2. 解析 `@Scheduled` 注解

Spring 容器启动时，ScheduledAnnotationBeanPostProcessor 会扫描所有被 Spring 管理的 bean，查找其中带有 @Scheduled 注解的方法。对于每个找到的方法，它会根据注解中的配置（如 cron 表达式、fixedRate、fixedDelay 等）来创建定时任务。

3. 注册定时任务

ScheduledAnnotationBeanPostProcessor 会将解析到的定时任务信息封装成任务执行计划（如 CronTask、FixedRateTask、FixedDelayTask 等），并将这些任务注册到任务调度器（TaskScheduler）中。在 Spring 中，TaskScheduler 是一个接口，用于定义任务的调度逻辑。

4. 执行定时任务

任务调度器根据注册的任务执行计划，在指定的时间或频率下触发任务的执行。Spring 提供了多种 TaskScheduler 的实现，如 ThreadPoolTaskScheduler，它内部使用 ScheduledExecutorService 来执行定时任务。当任务触发时，TaskScheduler 会为任务分配线程并执行。

5. 注意事项

单线程执行：默认情况下，所有 @Scheduled 任务都在同一个线程中顺序执行。如果某个任务执行时间较长，可能会影响到后续任务的执行。为了避免这种情况，可以通过配置多个线程的任务调度器来解决。
异常处理：如果 @Scheduled 方法在执行过程中抛出异常，默认情况下，Spring 不会重新调度该任务。需要根据实际需求配置异常处理策略。
集群环境：在集群环境中，如果多个实例都配置了相同的定时任务，可能会导致任务重复执行。需要额外的协调机制（如分布式锁）来确保任务只在一个实例上执行。