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("处理完成");
}
}