XXL-JOB:轻量级分布式任务调度平台

FreeGuideOnline 最新 2026-06-30

xml com.xuxueli xxl-job-core 2.3.1

- **编写配置类**(或直接在 `application.yml` 中配置):
```yaml
xxl:
  job:
    admin:
      addresses: http://调度中心IP:8080/xxl-job-admin
    executor:
      appname: 你的执行器名称
      ip:
      port: 9999                  # 执行器通讯端口
      logpath: /data/applogs/xxl-job/jobhandler
      logretentiondays: 30
  • 注入并启动执行器
    @Bean
    public XxlJobSpringExecutor xxlJobExecutor() {
        XxlJobSpringExecutor executor = new XxlJobSpringExecutor();
        executor.setAdminAddresses(adminAddresses);
        executor.setAppname(appname);
        executor.setIp(ip);
        executor.setPort(port);
        executor.setLogPath(logPath);
        executor.setLogRetentionDays(logRetentionDays);
        return executor;
    }
    

启动业务项目后,检查调度中心的“执行器管理”页面,在“OnLine 机器”列出现注册成功的地址即表示执行器已正常接入。

开发你的第一个任务

XXL-JOB 中的任务是通过添加 @XxlJob 注解来标记的,返回值为 void,参数为 String param(从调度中心传入的任务参数)。如果出现异常,捕获后可调用 XxlJobHelper.handleFail("错误信息") 通知调度中心任务失败。示例任务代码:

@Component
public class SampleJob {
    @XxlJob("demoJobHandler")
    public void demoJobHandler() throws Exception {
        String param = XxlJobHelper.getJobParam();
        System.out.println("接收到的参数:" + param);
        // 业务逻辑
        XxlJobHelper.handleSuccess("处理完成");
    }
}