Spring @Scheduled注解及工作原理

2025-06-18 17:50

本文主要是介绍Spring @Scheduled注解及工作原理,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《Spring@Scheduled注解及工作原理》Spring的@Scheduled注解用于标记定时任务,无需额外库,需配置@EnableScheduling,设置fixedRate、fixedDe...

1.@Scheduled注解定义

简单来说, @Scheduled是 Spring 提供的一个注解,用于在方法上标记定时任务。通过它,我们可以轻松地在指定的时间间隔或特定的时间点执行某些代码,而不需要引入额外的定时任务库。

举个例子:
假设你有一个方法需要每隔5分钟执行一次,你只需要在方法上加上 @Scheduled注解,并设置相应的属性即可。

2.配置 @Scheduled

在开始使用 @Scheduled 之前,我们需要做一些配置工作。首先,确保你的 Spring 项目中引入了 spring-boot-starter,因为它已经包含了必要的依赖。

2.1 开启定时任务支持

在你的主类(通常标注了 @SpringBootApplication 的类)上添加@EnableScheduling注解,以启用定时任务的支持。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;
@SpringBootApplication
@EnableScheduling
public class ScheduledDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(ScheduledDemoApplication.class, args);
    }
}

2.2 创建定时任务

接下来,我们创建一个服务类,并在其中定义一个定时任务方法。例如,每隔5秒打印一条消息:

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class ScheduledTasks {
    @Scheduled(fixedRate = 5000)
 public void reportCurrentTime() {
        System.out.println("每5秒执行一次任务,当前时间:" + System.currentTimeMillis());
    }
}

3. 常用属性

@Scheduled 注解提供了多种方式来配置定时任务的执行时间,主要包括以下几种

3.1 fixedRatejavascript

指定一个固定的时间间隔,以毫秒为单位,表示上一次任务开始执行后,多久再次执行。

@Scheduled(fixedRate = 5000) // 每5秒执行一次
public void fixedRateTask() {
    System.out.println("Fixed Rate Task - " + System.currentTimeMillis());
}

3.2 fixedDelay

指定一个固定的时间间隔,表示上一次任务执行完成后,等待多久再次执行。

@Scheduled(fixedDelay = 5000) // 上一次任务完成后5秒执行一次
public void fixedDelayTask() {
    System.out.println("Fixed Delay Task - " + System.currentTimeMillis());
}

3.3 cron

使用 cron 表达式确地指定任务的执行时间。cron 表达式可以让你定义复杂的时间计划。

@Scheduled(cron = "0 0/1 * * * ?") // 每分钟执行一次
public void cronTask() {
    System.out.println("Cron Task - " + System.currentTimeMillis());
}

4.工作原理

了解了如何使用 @Scheduled,那么它背后到底是如何运作的呢?让我们来深入探讨一下。

4.1 基于TaskScheduler

Spring 的定时任务是基于 TaskScheduler 接口实现的。当我们在方法上使用 @Scheduled 注解时,Spring 会自动为其创建一个调度器,并按照我们定义的时间计划来执行任务

4.2 使用 ThreadPoolTaskScheduler

默认情况下,Spring 使用 ThreadPoolTaskScheduler 作为TaskScheduler的实现类。它内部维护了一个线程池,用于执行定时任务。这样可以确保多个定时任务能够并发执行,而不会阻塞主线程。

注意: 如果你的应用中有多个定时任务,或者某些任务执行时间较长,建议自定义ThreadPoolTaskScheduler的线程池大小,以避免任务堆积或资源浪费。

4.3 定时任务的执行流程

1、初始化阶段:启动 Spring 应用时,@EnableScheduling 注编程解会触发 Spring 的配置,扫描所有被 @Scheduled 注解标记的方法。
2、注册任务:所有符合条件的定时任务方法会被注册到 TaskScheduler 中。
3、执行任务:根据配置的时间计划,TaskScheduler 会调度并在合适的线程中执行相应的任务方法。

5. 延时执行的定时任务

为了更好地理解 @Scheduled 的使用,我们来实现一个稍微复杂些的示例——延时执行任务。假设我们有一个任务需要在应用启动后延时10秒执行一次,然后每隔5秒重复执行。

5.1 创建定时任务类

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
publicclass DelayedScheduledTasks {
    privateboolean firstRun = true;
    @Scheduled(fixedRate = 5000, initialDelay = 10000)
    public void delayedTask() {
        if (firstRun) {
            System.out.println("延时10秒后首次执行任务,当前时间:" + System.currentTimeMillis());
            firstRun = false;
        } else {
            System.out.println("每5秒执行一次任务,当前时间:" + System.currentTimeMillis());
        }
    }
}

5.2 解释

fixedRate = 5000: 任务每5秒执行一次。
initialDelay = 10000: 应用启动后,延时10秒首次执行任务。

6.自定义TaskScheduler

有时候,默认的 ThreadPoolTaskScheduler 可能无法满足我们的需求,比如需要更高的并发能力或特定的线程名称模式。这时候,我们可以自定义一个 TaChina编程skScheduler Bean

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuraphption;
import org.springframework.scheduling.concurrent.ThreadPoolTaskScheduler;
@Configuration
publicclass SchedulerConfig {
    @Bean
    public ThreadPoolTaskScheduler taskScheduler() {
        ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
        scheduler.setPoolSize(10); // 设置线程池大小
        scheduler.setThreadNamePrefix("MyScheduler-"); // 设置线程名称前缀
        scheduler.initialize();
        return scheduler;
    }
}

通过上述配置,我们创建了一个拥有10个线程的线程池,并为每个线程命名,方便日志追踪和调试。

到此这篇关于Spring @Scheduled注解详解的文章就介绍到这了,更多相关Spring @Scheduled注解内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于Spring @Scheduled注解及工作原理的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1155121

相关文章

SpringBoot中使用Flux实现流式返回的方法小结

《SpringBoot中使用Flux实现流式返回的方法小结》文章介绍流式返回(StreamingResponse)在SpringBoot中通过Flux实现,优势包括提升用户体验、降低内存消耗、支持长连... 目录背景流式返回的核心概念与优势1. 提升用户体验2. 降低内存消耗3. 支持长连接与实时通信在Sp

Spring Boot 实现 IP 限流的原理、实践与利弊解析

《SpringBoot实现IP限流的原理、实践与利弊解析》在SpringBoot中实现IP限流是一种简单而有效的方式来保障系统的稳定性和可用性,本文给大家介绍SpringBoot实现IP限... 目录一、引言二、IP 限流原理2.1 令牌桶算法2.2 漏桶算法三、使用场景3.1 防止恶意攻击3.2 控制资源

Mac系统下卸载JAVA和JDK的步骤

《Mac系统下卸载JAVA和JDK的步骤》JDK是Java语言的软件开发工具包,它提供了开发和运行Java应用程序所需的工具、库和资源,:本文主要介绍Mac系统下卸载JAVA和JDK的相关资料,需... 目录1. 卸载系统自带的 Java 版本检查当前 Java 版本通过命令卸载系统 Java2. 卸载自定

springboot下载接口限速功能实现

《springboot下载接口限速功能实现》通过Redis统计并发数动态调整每个用户带宽,核心逻辑为每秒读取并发送限定数据量,防止单用户占用过多资源,确保整体下载均衡且高效,本文给大家介绍spring... 目录 一、整体目标 二、涉及的主要类/方法✅ 三、核心流程图解(简化) 四、关键代码详解1️⃣ 设置

Java Spring ApplicationEvent 代码示例解析

《JavaSpringApplicationEvent代码示例解析》本文解析了Spring事件机制,涵盖核心概念(发布-订阅/观察者模式)、代码实现(事件定义、发布、监听)及高级应用(异步处理、... 目录一、Spring 事件机制核心概念1. 事件驱动架构模型2. 核心组件二、代码示例解析1. 事件定义

SpringMVC高效获取JavaBean对象指南

《SpringMVC高效获取JavaBean对象指南》SpringMVC通过数据绑定自动将请求参数映射到JavaBean,支持表单、URL及JSON数据,需用@ModelAttribute、@Requ... 目录Spring MVC 获取 JavaBean 对象指南核心机制:数据绑定实现步骤1. 定义 Ja

javax.net.ssl.SSLHandshakeException:异常原因及解决方案

《javax.net.ssl.SSLHandshakeException:异常原因及解决方案》javax.net.ssl.SSLHandshakeException是一个SSL握手异常,通常在建立SS... 目录报错原因在程序中绕过服务器的安全验证注意点最后多说一句报错原因一般出现这种问题是因为目标服务器

Java实现删除文件中的指定内容

《Java实现删除文件中的指定内容》在日常开发中,经常需要对文本文件进行批量处理,其中,删除文件中指定内容是最常见的需求之一,下面我们就来看看如何使用java实现删除文件中的指定内容吧... 目录1. 项目背景详细介绍2. 项目需求详细介绍2.1 功能需求2.2 非功能需求3. 相关技术详细介绍3.1 Ja

springboot项目中整合高德地图的实践

《springboot项目中整合高德地图的实践》:本文主要介绍springboot项目中整合高德地图的实践,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一:高德开放平台的使用二:创建数据库(我是用的是mysql)三:Springboot所需的依赖(根据你的需求再

spring中的ImportSelector接口示例详解

《spring中的ImportSelector接口示例详解》Spring的ImportSelector接口用于动态选择配置类,实现条件化和模块化配置,关键方法selectImports根据注解信息返回... 目录一、核心作用二、关键方法三、扩展功能四、使用示例五、工作原理六、应用场景七、自定义实现Impor