🏗️ 系统架构概览
首先,让我们通过一个架构图来理解整个系统的组件关系:
执行器集群 调度中心 业务应用1 业务应用2 业务应用3 调度线程池 调度中心后端 用户/管理员 调度中心 Web界面 调度数据库 执行器集群
🔄 任务从0到1的完整执行流程
下面通过一个序列图来展示任务从创建到执行的完整生命周期:
用户/管理员 调度中心Admin 数据库 调度线程 触发线程 执行器 任务处理器 第一阶段: 任务配置 1. 登录Web界面创建任务 2. 保存任务信息(xxl_job_info) 存储任务ID、 Cron表达式、 执行器路由策略等 第二阶段: 执行器注册 3. 启动时自动注册 4. 更新执行器地址(xxl_job_registry) 第三阶段: 任务调度 5. 扫描未来5秒的任务 返回待执行任务列表 loop [每秒检查] 6. 提交到触发线程池 7. 发送HTTP触发请求 包含jobId、参数、 签名等信息 第四阶段: 任务执行 8. 验证请求签名 9. 查找并执行对应JobHandler 10. 执行业务逻辑 11. 返回执行结果 第五阶段: 结果回调 12. 回调通知执行结果 13. 更新任务日志状态 14. 可选: 发送告警通知 用户/管理员 调度中心Admin 数据库 调度线程 触发线程 执行器 任务处理器
📋 详细步骤分解
第一阶段:任务配置(1-2步)
在调度中心Web界面创建任务:
java
// 数据库表: xxl_job_info
job_id: 1
job_desc: "示例任务"
cron: "0 0 2 * * ?" // 每天凌晨2点执行
executor_route_strategy: "FIRST" // 路由策略: 第一个
executor_handler: "demoJobHandler" // 任务处理器
第二阶段:执行器注册(3-4步)
执行器启动时自动注册:
java
// 执行器配置
@Bean
public XxlJobSpringExecutor xxlJobExecutor() {
XxlJobSpringExecutor xxlJobExecutor = new XxlJobSpringExecutor();
xxlJobExecutor.setAdminAddresses("http://localhost:8080/xxl-job-admin");
xxlJobExecutor.setAppname("xxl-job-executor-sample");
xxlJobExecutor.setPort(9999);
return xxlJobExecutor;
}
第三阶段:任务调度(5-7步)
调度线程扫描任务:
java
// JobScheduleHelper 类中的扫描逻辑
public void start() {
thread.scheduleAtFixedRate(new Runnable() {
@Override
public void run() {
// 1. 扫描未来5秒内需要执行的任务
// 2. 推送到触发线程池
}
}, 0, 5, TimeUnit.SECONDS);
}
第四阶段:任务执行(8-11步)
执行器接收请求并处理:
java
// 1. 执行器接收HTTP请求
@RestController
public class JobApiController {
@PostMapping("/run")
public ReturnT<String> run(@RequestBody TriggerParam triggerParam) {
// 验证、查找Handler、执行
}
}
// 2. 业务任务处理器
@Component
public class DemoJobHandler {
@XxlJob("demoJobHandler")
public void execute() throws Exception {
// 具体的业务逻辑
logger.info("XXL-JOB, Hello World.");
}
}
第五阶段:结果回调(12-14步)
执行结果处理:
java
// 执行器回调调度中心
public void callback(List<HandleCallbackParam> callbackParamList) {
// 将执行结果回调给调度中心
// 调度中心更新 xxl_job_log 表状态
}
🎯 关键设计要点
1. 调度与执行分离
- 调度中心:负责任务管理、调度决策、结果收集
- 执行器:负责具体业务逻辑执行
2. 线程池分级
java
// 快慢线程池设计
fastTriggerPool: 处理正常任务(队列: 2000)
slowTriggerPool: 处理超时任务(队列: 5000)
3. 路由策略
- FIRST:第一个
- LAST:最后一个
- ROUND:轮询
- RANDOM:随机
- CONSISTENT_HASH:一致性哈希
4. 失败处理
- 自动重试机制
- 失败告警(邮件、钉钉等)
- 死信队列处理
💡 总结
XXL-JOB的任务执行流程体现了清晰的职责分离 和事件驱动架构:
- 配置驱动:通过Web界面配置触发整个流程
- 注册发现:执行器自动注册,调度中心动态感知
- 时间驱动:Cron表达式驱动调度决策
- 异步处理:线程池异步化处理,提高吞吐量
- 结果回调:完整的执行结果反馈机制
这种设计保证了系统的高可用、可扩展和易维护性。