JAVA后端开发——用 Spring Boot 实现定时任务

最新推荐文章于 2025-07-28 17:30:49 发布

1candobetter

最新推荐文章于 2025-07-28 17:30:49 发布

阅读量431

点赞数 9

CC 4.0 BY-SA版权

分类专栏： JAVA开发文章标签： java spring boot 开发语言

本文链接：https://blog.youkuaiyun.com/pgone1/article/details/149716173

JAVA开发专栏收录该内容

6 篇文章

订阅专栏

在后端开发中，执行定时任务是一个极其常见的需求，无论是每日的数据报表生成、定时的缓存清理，还是自动化同步第三方数据。借助 Spring Boot 内置的强大功能，我们只需几个简单的注解，就能实现稳定、可靠且极易维护的定时任务。

第一步：开启定时任务的总开关 (@EnableScheduling)

我们首先要告诉 Spring Boot：“嘿，我准备在这个项目里使用定时任务功能了，请帮我把相关的组件都准备好！”

这个“通知”的动作，通过一个简单的注解就能完成。找到你的 Spring Boot 项目的主启动类（通常是名为 ...Application.java 的文件），在类的声明上方添加 @EnableScheduling 注解。

package com.ruoyi;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling; // 1. 导入注解

/**
 * 启动程序
 */
@SpringBootApplication
@EnableScheduling // 2. 加上这个注解，开启定时任务功能！
public class RuoYiApplication {
    public static void main(String[] args) {
        SpringApplication.run(RuoYiApplication.class, args);
    }
}

原理：@EnableScheduling 注解就像一个总开关。一旦加上它，Spring Boot 在启动时就会自动创建一个后台任务调度器（Task Scheduler）。这个调度器会时刻准备着，去发现并执行我们后续定义的具体任务。

切记：如果没有这一步，后面所有的配置都将是徒劳！

第二步：创建你的任务执行类 (@Component)

接下来，我们需要一个专门的类来存放我们的定时任务逻辑。这个类必须是一个能被 Spring 容器管理的 Bean，这样调度器才能找到它。

最简单的方式就是创建一个新的 Java 类，并在其上方添加 @Component 注解。

package com.ruoyi.web.core.task;

import com.cmgii.trust.third.dtcp.service.IDtcpService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

/**
 * 定时任务调度类
 * @author YourName
 */
@Component // 1. 声明这是一个Spring组件，让Spring容器来管理它
public class SyncTask {

    // 2. 注入你真正要执行业务逻辑的Service
    @Autowired
    private IDtcpService dtcpService;
    
    // 我们将在这里定义具体的定时任务...
}

原理：@Component 注解告诉 Spring：“请为我这个 SyncTask 类创建一个实例，并放到你的容器里备用。” 这样，当调度器需要执行任务时，就能从容器中拿到这个实例并调用它的方法。

第三步：定义具体的定时任务 (@Scheduled)

通过在方法上添加 @Scheduled 注解来完成。在我们的 SyncTask 类中，添加如下方法：

// ... (接上一步的代码) ...
import org.springframework.scheduling.annotation.Scheduled;

@Component
public class SyncTask {

    @Autowired
    private IDtcpService dtcpService;

    /**
     * 每小时的第0分0秒执行一次，同步数据产品。
     * 这是一个非常常见的定时设置。
     */
    @Scheduled(cron = "0 0 * * * ?") // 3. 定义任务的执行时间表！
    public void syncDataProducts() {
        System.out.println("定时任务开始：同步数据产品...");
        // 调用核心业务逻辑
        dtcpService.syncDataProducts();
        System.out.println("定时任务结束：同步数据产品完成。");
    }

    /**
     * 演示：每5分钟执行一次，同步交易订单。
     * cron = "0 */5 * * * ?"
     */
    @Scheduled(cron = "0 */5 * * * ?")
    public void syncTradeOrders() {
        System.out.println("定时任务开始：同步交易订单...");
        dtcpService.syncTradeOrders();
        System.out.println("定时任务结束：同步交易订单完成。");
    }
}