SpringBoot 定时任务 @Scheduled表达式

本文介绍了如何在SpringBoot应用中设置定时任务,包括添加spring-context-support依赖、启用定时任务功能、使用@Scheduled注解配置cron表达式,并通过示例演示了具体步骤和cron表达式的含义。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.需求分析

业务在某一特定时刻完成操作,例如货品自动上架或者流水定时结账等任务,因此我们需要设置定时任务。

2.实现技术

为了实现定时任务,我们需要使用Scheduled组件。它是spring3.0中内置的定时任务器,可以周期的执行一些功能,其依赖在spring-context-support.jar中。简单来说,我们在springBoot对应方法上添加@Scheduled注解,再配置参数即可实现定时任务。

3.具体步骤

        1.在pox.xml中添加spring-context-support依赖

        <!--Spring定时任务-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
        </dependency>

 注:这里一般不用写<version>标签,maven会根据spring自动匹配对应版本,我这里是5.3.15 ​​​​​

        2.在启动类上添加注解@EnableScheduling,控制开启定时任务功能。

package com.tjetc;

// #EnableXXX 开启某项功能的注解 是SpringBoot的风格
@EnableScheduling //开启定时任务
@SpringBootApplication
public class SpringBootMybatisApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringBootMybatisApplication.class, args);
    }
}

        3.在目标类中添加@Component组件注解,将目标类对象纳入SpringBoot容器管理中(否则目标类不在容器内,无法启动定时功能);在目标方法前面添加@Scheduled定时注解,用@Scheduled(cron)表达式声明定时任务周期。

package com.tjetc.schedule;

//要使用Springboot定时任务执行某个方法,首先方法所在类的对象纳入springboot容器管理
@Component
public class ScheduleDemo {
//    @Scheduled的 是Springboot根据Cron表达式的内容 根据周期性或一次性执行方法
    @Scheduled(cron = "0/2 * * * * *")
    public void testDemo(){
//        定时任务要执行的逻辑
        System.out.println("定时执行逻辑"+ LocalDateTime.now());
    }
}

注意:这里cron表达式"  "内至少6个参数,按顺序每个参数值有其特定含义。具体解析如下: 

位置

时间域名

允许值

允许的特殊字符

1

0-59

, - * /

2

分钟

0-59

, - * /

3

小时

0-23

, - * /

4

1-31

, - * / L W C

5

1-12

, - * /

6

星期

1-7(周日到周六)

, - * /? L C #

7

年(可选)

1970-2099

, - * /

详细介绍一下每个位置允许的特殊符号 , - * / 等的含义:

逗号( , )可用于所有字段,表示对应时间值,特别说明,在星期字段中1-7表示日到六

减号(-)可用于所有字段,表示对应时间范围,例如1-5在分钟时间段,表示在第1分钟到第5分钟时间范围。

星号(*)可用于所有字段,表示时间域的每一时刻,例如每分钟,每小时,每日,每月等

斜杠(/)可用于所有字段,表示一个等步长序列,例如2/1在秒时间域,表示在时钟第2秒开始,每1秒触发一次。

问号(?) 只用于星期字段内,表示“无意义的占位符”,判断条件中,不考虑星期的时间范围

井号(#)只用于星期字段内,表示当月某个具体星期几,例如6#3,表示当月第三个星期五,1#2,表示当月第二个星期日。

L 只用于日和星期字段内,表示“LAST”的意思;在日期中L 表示当月最后一天,在星期中L 表示周六;如有X出现在L前面,则表示当月最后X天,例如7L,表示当月最后七天。

只用于日期字段内,和日期值联合使用,表示计算日期距离最近的工作日,例如15W表示距离当月15号最近的工作日;

C只用于日期和星期字段内,表示"Calender"的意思;在日期中表示目标日期后的每一天,在星期中表示目标星期后的每一天;例如25C,表示日期25号后面每一天,2C表示星期1后面的每一天。

 4.示例演示

接下来我们来看一个示例,按照步骤三配置项目,可以看到在ScheduleDemo类中定义了一个cron表达式,设定从0秒开始,每两秒执行一次testDemo打印任务,运行结果如下:

总结:

在Springboot中开启定时任务,首先添加spring-context-support依赖,然后在启动类中添加@EnableScheduling注解,开启定时任务支持,最后在目标类的方法中添加@Scheduled(cron)表达式,执行周期任务。

### 如何在 Spring Boot 中使用 `@Scheduled` 注解实现定时任务 #### 配置主类或配置类 为了启用定时任务功能,在 Spring Boot 的主应用程序类或者某个配置类上需要添加 `@EnableScheduling` 注解。这一步是必不可少的,因为该注解会激活 Spring 容器内的调度机制[^2]。 ```java import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.scheduling.annotation.EnableScheduling; @SpringBootApplication @EnableScheduling // 启用定时任务功能 public class MyApplication { public static void main(String[] args) { SpringApplication.run(MyApplication.class, args); } } ``` --- #### 创建定时任务方法 创建一个普通的组件类(通过 `@Component` 或其他类似的注解标记),并在其中定义带有 `@Scheduled` 注解的方法。此注解用于指定任务执行的时间间隔或其他触发条件[^3]。 以下是几种常见的定时任务设置方式: 1. **基于固定时间间隔的任务** 可以使用 `fixedRate` 属性来设定每次任务之间的最小间隔时间(单位为毫秒)。 ```java import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; @Component public class ScheduledTasks { @Scheduled(fixedRate = 5000) // 每隔 5 秒运行一次 public void fixedRateTask() { System.out.println("Fixed Rate Task executed at: " + System.currentTimeMillis()); } } ``` 2. **基于延迟时间间隔的任务** 如果希望当前任务完成后等待一段时间再启动下一个任务,则可以使用 `fixedDelay` 属性。 ```java @Scheduled(fixedDelay = 10000) // 当前任务结束后等待 10 秒再运行下一次 public void fixedDelayTask() { System.out.println("Fixed Delay Task executed at: " + System.currentTimeMillis()); } ``` 3. **基于 Cron 表达式的复杂任务计划** 对于更复杂的场景,比如每天凌晨两点执行某项操作,可以通过 `cron` 属性提供自定义表达式。 ```java @Scheduled(cron = "0 0/5 * * * ?") // 每五分钟运行一次 public void cronTask() { System.out.println("Cron Task executed at: " + System.currentTimeMillis()); } @Scheduled(cron = "0 0 2 * * ?") // 每天凌晨两点运行一次 public void dailyCronTask() { System.out.println("Daily Cron Task executed at: " + System.currentTimeMillis()); } ``` --- #### 注意事项 - 默认情况下,`@Scheduled` 基于单线程池工作。如果多个任务可能重叠或耗时较长,建议调整线程池大小以提高并发能力。 - 若要修改默认行为,可以在配置文件中加入如下属性: ```properties spring.task.scheduling.pool.size=5 # 设置线程池大小为 5 ``` - 时间计算均基于 JVM 所在服务器的本地时区。因此需注意部署环境与时区的一致性问题。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

老大哥注释着你

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值