xxljob是分布式调度系统,调度器和执行器部署在不同的节点上,需要进行远程服务调用来进行交互。
1. 协议
采用http协议进行交互。
admin端使用springboot框架,典型的mvc架构。
executor端采用netty通信,之上采用http协议交互。
序列化采用json。
2. 两个重要接口
AdminBiz和ExecutorBiz两个接口定义了admin和executor间的所有通信方法。
2.1 AdminBiz
这个接口定义了admin端可以处理所有来自executor的请求类型。
public interface AdminBiz {
/**
* 执行器执行完任务后,回调调度器的方法来返回执行结果
*/
ReturnT<String> callback(List<HandleCallbackParam> callbackParamList);
/**
* 执行器发送注册信息给调度器,该方法也用于实现心跳功能
*/
ReturnT<String> registry(RegistryParam registryParam);
/**
* 执行器取消注册
*/
ReturnT<String> registryRemove(RegistryParam registryParam);
}
这个接口有两个实现类,一个是admin端的实现(AdminBizImpl),用来真实的处理来自调度器的请求,一个是executor端的实现(AdminBizClient,因为这个类所定义的方法都是由executor端发起的,所以也可以任务executor端是client端),用于发送http请求给admin端。
2.1 ExecutorBiz
这个接口定义的是executor端可以响应的全量的来自admin端的请求类型。
public interface ExecutorBiz {
/**
* 调度器查看执行器是否处于active状态
*/
ReturnT<String> beat();
/**
* 调度器查看执行器是否处于idle状态
*/
ReturnT<String> idleBeat(IdleBeatParam idleBeatParam);
/**
* 调度器触发执行器进行任务执行
*/
ReturnT<String> run(TriggerParam triggerParam);
/**
* 调度器kill执行器正在执行的任务
*/
ReturnT<String> kill(KillParam killParam);
/**
* 调度器获取执行器的执行日志
*/
ReturnT<LogResult> log(LogParam logParam);
}
这个接口也有两个实现类,executor端的实现类ExecutorBizImpl,它用于真实处理来自调度器的请求;admin端的实现类ExecutorBizClient(在这种场景下,admin端是发起请求的一端,因此可以认为是client端)用于发起http请求。