XXL-JOB支持动态添加定时任务,这意味着你可以在系统运行时,不重启服务的情况下添加新的任务。以下是通过XXL-JOB动态添加定时任务的一般步骤:
1. 任务开发
首先,你需要开发一个任务类,该类需要实现IJobHandler
接口,并重写execute
方法。例如:
java
public class MyJob implements IJobHandler {
@Override
public ReturnT<String> execute(String param) throws Exception {
// 任务执行逻辑
return ReturnT.SUCCESS;
}
}
2. 注册任务
然后,你需要在执行器中注册这个任务。通常,这可以通过注解@JobHandler
来实现,并在执行器的Spring
配置中添加一个@Bean
来注册这个任务。
java
@JobHandler(value=“myJobHandler”)
public class MyJob implements IJobHandler {
// …
}
@Bean
public MyJob myJob() {
return new MyJob();
}
3. 通过API添加任务
XXL-JOB提供了一个API来动态添加任务。你可以调用这个API来添加任务到调度中心。以下是添加任务所需的参数:
- jobGroup:任务所属的任务组ID。
- jobDesc:任务描述。
- cron:cron表达式,定义任务的执行时间规则。
- author:任务作者。
- executorRouteStrategy:执行器路由策略。
- executorHandler:执行器任务handler。
- executorParam:执行器任务参数。
- glueType:任务脚本类型,如BEAN。
- executorBlockStrategy:执行器阻塞处理策略。
- executorTimeout:执行器任务超时时间。
- executorFailRetryCount:执行器任务失败重试次数。
你可以使用HTTP客户端发送一个POST请求到XXL-JOB调度中心的API来添加任务。以下是一个使用Java代码发送POST请求的例子:
java
String jobInfoJson = “{“jobGroup”:1,“jobDesc”:“动态添加的任务”,“cron”:“0 0/1 * * * ?”,“author”:“admin”,“executorRouteStrategy”:“FIRST”,“executorHandler”:“myJobHandler”,“executorParam”:”",“glueType”:“BEAN”,“executorBlockStrategy”:“SERIAL_EXECUTION”,“executorTimeout”:0,“executorFailRetryCount”:0}";
// 使用HttpURLConnection发送POST请求
URL url = new URL(“http://调度中心地址/xxl-job-admin/api/jobinfo/add”);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod(“POST”);
conn.setRequestProperty(“Content-Type”, “application/json”);
conn.setDoOutput(true);
// 发送请求参数
try(OutputStream os = conn.getOutputStream()) {
byte[] input = jobInfoJson.getBytes(“utf-8”);
os.write(input, 0, input.length);
}
// 获取响应
try(BufferedReader br = new BufferedReader(
new InputStreamReader(conn.getInputStream(), “utf-8”))) {
StringBuilder response = new StringBuilder();
String responseLine = null;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println(response.toString());
}
conn.disconnect();
注意事项
- 确保调度中心API的URL是正确的。
- 根据实际情况调整POST请求中的参数。
- 调度中心需要有足够的权限来添加任务。
通过这种方式,你可以在不停止服务的情况下,动态地向XXL-JOB调度中心添加新的定时任务。