Scaffold-Boot-3.0框架使用文档Scaffold-Boot-3.0框架使用文档
首页
快速开始
变更记录
Source
首页
快速开始
变更记录
Source
  • 开始
  • 基础

    • 目录结构
    • 代码生成器
    • 增删改查
    • 异常处理
    • Knife4j(Swagger)文档
    • 登录&登出
    • 系统安全
    • 数据字典
    • Excel处理
    • 文件上传下载
    • 工具类
    • 定时任务
    • 微信集成
    • 短信服务
    • 参数配置
    • 接口限流
    • 日志审计
    • 数据脱敏
    • 网站管理
  • AI开发

    • AI项目工程结构
    • MCP服务
    • AI开发模式介绍
  • 开发规范
  • 常见问题
  • 深入

    • 配置详解-Config类
    • 配置详解-Yml配置文件
  • 生命周期

    • SonarQube代码质量保证
    • 部署到测试环境
    • 部署到正式环境
  • 优秀案例

    • Excel导入完整案例
  • 信创专区

    • 海量数据库
    • 神通数据库
    • 达梦数据库
    • 麒麟v10安装插件
  • 框架升级

定时任务

章节简介

本章节介绍如何在系统中配置定时任务,并执行定时任务
定时任务基于XXL-JOB实现,详情可参阅XXL-JOB官网文档

创建XXL-JOB定时任务

开发过程中,经常需要使用定时任务,例如:定时发送邮件、定时清理数据等。

  1. 新建一个相关Task类,并放入对应的包的task文件夹下
  2. 在Task类上添加@Component注解
  3. 在定时任务方法上打上@XxlJob("定时任务名称")注解,此方法名即为定时任务执行器中的JobHandler名称,注意要保持唯一性
@Slf4j
@Transactional
@Component
public class SendPayFeesTask {
    
    @XxlJob("sendPayFeesTask")
    public void sendPayFees() {
        XxlJobHelper.log("定时任务开始...");
        //定时任务逻辑...
        XxlJobHelper.log("定时任务完成...");
    }
}

配置定时任务

1. 在xxl-job系统中配置

  • 注意jobHandler中输入的与@XxlJob注解中的值保持一致
  • 注意Cron字段为Cron表达式,例如:每天凌晨1点执行,则输入0 0 1 * * ?
    img_1.png

2. 在配置文件中配置

  • 通过enable字段控制是否启用定时任务
  • 通过app-name应用名称,例如:vip-member-api
  • 注意address字段为定时任务执行器地址,例如:http://localhost:8081/xxl-job-admin
  • 注意log-path字段为定时任务日志路径,例如:/home/data/applogs/xxl-job/jobhandler
xxl-job:
  enable: true
  accessToken:
  app-name: 应用名称
  ip:
  log-path: /home/data/applogs/xxl-job/jobhandler
  log-retention-days: -1
  port: 9999
  address: http://localhost:8081/xxl-job-admin

提示

测试环境通用XXL-JOB地址为:https://sungent.fyxmt.com/xxl-job-admin
账号密码请联系技术经理索取

在 GitLab 上编辑此页
最后更新: 2025/6/16 09:56
贡献者: xuew, guobenjia
Prev
工具类
Next
微信集成