SpringBoot定时任务

最新推荐文章于 2025-03-15 21:32:34 发布

JavadeSon

最新推荐文章于 2025-03-15 21:32:34 发布

阅读量196

点赞数

分类专栏： SpringBoot 文章标签： spring boot java

本文链接：https://blog.youkuaiyun.com/JavadeSon/article/details/108159316

版权

SpringBoot 专栏收录该内容

4 篇文章

订阅专栏

本文介绍了SpringBoot中如何实现定时任务，包括基于注解@Scheduled的静态定时任务和基于接口SchedulingConfigurer的动态定时任务。详细讲解了@Scheduled的参数和cron表达式的使用，提供了多个cron表达式实例。

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

一、概述

（1）SpringBoot定时任务通常来讲就是给程序设定一个时间让它在指定时间运行。

（2）要开启定时任务，只需在SpringBoot中做几个简单的配置

二、案例一：基于注解@Scheduled（静态的）

基于注解@Scheduled默认为单线程，开启多个任务时，任务的执行时机会受上一个任务执行时间的影响。

【1】创建一个SpringBoot程序，这里我使用的是SpringBoot 2.3.3版本

【2】在SpringBoot的启动类上配置@EnableScheduling开启定时任务

@SpringBootApplication
@EnableScheduling  // 开启定时任务
public class Demo02Application {

    public static void main(String[] args) {
        SpringApplication.run(Demo02Application.class, args);
    }

}

【3】创建一个Spring的配置类，写一个定时方法

@Configuration      //标记配置类
public class StaticScheduleTask {
    //添加定时任务
    @Scheduled(cron = "0/3 * * * * ?")
    //或直接指定时间间隔，例如：每3秒执行一次
    //@Scheduled(fixedRate=3000)
    private void configureTasks() {
        System.err.println("执行静态定时任务时间: " + LocalDateTime.now());
    }
}

【4】控制台打印

这里可以看到，每隔三秒，定时任务就会执行一次，但是我们要改变执行时间时，需要重启程序。

三、案例二：基于接口SchedulingConfigurer（动态的）

【1】pom.xml中添加依赖

<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
   </dependency>
<!--添加MySql依赖 -->
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
</dependency>
<!--添加Mybatis启动器 配置mybatis的一些初始化的东西-->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.1.3</version>
</dependency>
<!-- 添加mybatis依赖 -->
<dependency>
   <groupId>org.mybatis</groupId>
   <artifactId>mybatis</artifactId>
   <scope>compile</scope>
</dependency>

【2】添加数据库记录

DROP DATABASE IF EXISTS `socks`;
CREATE DATABASE `socks`;
USE `SOCKS`;
DROP TABLE IF EXISTS `cron`;
CREATE TABLE `cron`  (
  `cron_id` varchar(30) NOT NULL PRIMARY KEY,
  `cron` varchar(30) NOT NULL  
);
INSERT INTO `cron` VALUES ('1', '0/3 * * * * ?');

【3】application.xml配置文件配置数据源

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/socks
    username: root
    password: 1234

【4】创建定时类

@Configuration      //标记配置类
public class DynamicScheduleTask implements SchedulingConfigurer {
    @Mapper
    public interface CronMapper {
        @Select("select cron from cron limit 1")
        public String getCron();
    }

    @Resource      //注入mapper
    CronMapper cronMapper;

    /**
     * 执行定时任务
     * @param taskRegistrar
     */
    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.addTriggerTask(
                //1.添加任务内容(Runnable)
                () -> System.out.println("执行动态定时任务: " + LocalDateTime.now().toLocalTime()),
                //2.设置执行周期(Trigger)
                triggerContext -> {
                    //2.1 从数据库获取执行周期
                    String cron = cronMapper.getCron();
                    //2.2 合法性校验.
                    if (StringUtils.isEmpty(cron)) {
                        // Omitted Code ..
                    }
                    //2.3 返回执行周期(Date)
                    return new CronTrigger(cron).nextExecutionTime(triggerContext);
                }
        );
    }
}

【5】启动SpringBoot测试

这里可以看到两个定时任务都在执行，而这个动态的定时任务，你可以在数据库对core的表达式数据进行修改，这里会直接更改执行时间而无需重启程序。对于这个动态的定时类，涉及lambda表示和内部类的知识，不懂的可以自行百度。

四、对上面用到的和定时相关的注解的总结和cron表达式的说明。

【注解】

（1）@EnableScheduling：加在启动类上，开启定时任务

（2）@Scheduled：加在方法上，表示为定时方法

（3）@Scheduled的几个参数：

fixedRate是每一定时间执行一次任务，是从上一次方法执行开始的时间算起，如果上一次方法阻塞住了，下一次也是不会执行，但是在阻塞这段时间内累计应该执行的次数，当不再阻塞时，一下子把这些全部执行掉，而后再按照固定速率继续执行。
fixedDelay是每隔一定时间执行一次任务，是以上一次方法执行完开始算起，如上一次方法执行阻塞住了，那么直到上一次执行完，并间隔给定的时间后，执行下一次。
cron表达式可以定制化执行任务，但是执行的方式是与fixedDelay相近的，也是会按照上一次方法结束时间开始算起。
initialDelay 。如： @Scheduled(initialDelay = 10000,fixedRate = 15000
这个定时器就是在上一个的基础上加了一个initialDelay = 10000 意思就是在容器启动后,延迟10秒后再执行一次定时器,以后每15秒再执行一次该定时器。

【表达式】

Cron表达式是一个字符串，字符串以5或6个空格隔开，分为6或7个域，每一个域代表一个含义，Cron有如下两种语法格式：

（1） Seconds Minutes Hours DayofMonth Month DayofWeek Year

（2）Seconds Minutes Hours DayofMonth Month DayofWeek

(*)星号：可以理解为每的意思，每秒，每分，每天，每月，每年...
(?)问号：只能用在DayofMonth和DayofWeek两个域。它也匹配域的任意值，但实际不会。因为DayofMonth和DayofWeek会相互影响。例如想在每月的20日触发调度，不管20日到底是星期几，则只能使用如下写法： 13 13 15 20 * ?, 其中最后一位只能用？，而不能使用*，如果使用*表示不管星期几都会触发，实际上并不是这样。
(-)减号：表达一个范围，如在小时字段中使用“10-12”，则表示从10到12点，即10,11,12
(,)逗号：表达一个列表值，如在星期字段中使用“1,2,4”，则表示星期一，星期二，星期四
(/)斜杠：如：x/y，x是开始值，y是步长，比如在第一位（秒） 0/15就是，从0秒开始，每15秒，最后就是0，15，30，45，60    另：*/y，等同于0/y
(L)表示最后，只能出现在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。
(W)表示有效工作日(周一到周五),只能出现在DayofMonth域，系统将在离指定日期的最近的有效工作日触发事件。例如：在 DayofMonth使用5W，如果5日是星期六，则将在最近的工作日：星期五，即4日触发。如果5日是星期天，则在6日(周一)触发；如果5日在星期一到星期五中的一天，则就在5日触发。另外一点，W的最近寻找不会跨过月份 。
(LW)这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。
(#)用于确定每个月第几个星期几，只能出现在DayofMonth域。例如在4#2，表示某月的第二个星期三。

【常用表达式例子】

　　（1）0 0 2 1 * ? * 表示在每月的1日的凌晨2点调整任务

　　（2）0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15执行作业

　　（3）0 15 10 ? 6L 2002-2006 表示2002-2006年的每个月的最后一个星期五上午10:15执行作

　　（4）0 0 10,14,16 * * ? 每天上午10点，下午2点，4点

　　（5）0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时

　　（6）0 0 12 ? * WED 表示每个星期三中午12点

　　（7）0 0 12 * * ? 每天中午12点触发

　　（8）0 15 10 ? * * 每天上午10:15触发

　　（9）0 15 10 * * ? 每天上午10:15触发

　　（10）0 15 10 * * ? * 每天上午10:15触发

　　（11）0 15 10 * * ? 2005 2005年的每天上午10:15触发