Quartz 定时任务使用指南

任务类型概述

pig 框架支持以下四种任务类型:

  1. Spring Bean 类型:将任务定义为 Spring Bean,便于在 Spring 应用中集成和使用
  2. REST 类型:将任务封装为 REST 接口,通过 HTTP 请求触发执行,适用于跨系统任务调度
  3. Java 类型(反射):以 Java 类的形式定义任务,通过反射机制执行
  4. Jar 类型(java -jar):将任务打包为可执行 Jar 文件,通过命令行触发执行

Quartz 任务必须放在 pig-quartz 模块中才能被正确加载和识别,无法跨服务加载其他服务的类或 bean。

详细配置指南

1. Spring Bean 类型任务

参数说明

参数说明
类型选择 spring bean
执行路径留空
执行文件填写 Spring Bean 的名称,如 demo
执行方法指定要执行的 Bean 方法名称
执行参数方法的输入参数

执行方法的返回值必须是 String 类型,通过相关枚举返回执行逻辑的成功或失败状态。

2. REST 调用类型

应用内调用时,请确保目标接口直接对外暴露,否则会出现 401 错误。

3. Jar 类型任务

Jar 类型任务本质是定时执行 java -jar 执行路径 执行参数 命令。

参数说明

参数说明
类型选择 jar
执行路径服务器上 Jar 包所在的完整路径
执行文件留空
执行方法留空
执行参数java -jar 执行时需要的额外参数

4. Java 类型任务(反射机制)

通过反射机制调用应用中的指定类和方法。

参数说明

参数说明
类型选择 java
执行路径留空
执行文件类的全限定名(包含包名)
执行方法目标类中的方法名
执行参数一个 String 类型的参数

执行方法的返回值必须是 String 类型,通过相关枚举返回执行逻辑的成功或失败状态。

调试与排查

如果遇到任务调用失败等问题,请使用 DEBUG 模式调试以下核心业务逻辑类:

♥️ 获取支持

遇到问题?

如果您在使用过程中遇到任何问题、有功能建议或需求,请点击此卡片前往 Gitee 仓库提交 Issue。