xxl-job源码阅读一（客户端）
1、源码入口
使用xxl-job的时候，需要引入一个jar，然后还需要往Spring容器注入XxlJobSpringExecutor
<dependency>
<groupId>com.xuxueli</groupId>
<artifactId>xxl-job-core</artifactId>
<version>2.3.0</version>
</dependency>
@Bean
public XxlJobSpringExecutor xxlJobExecutor() {
XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
xxlJobSpringExecutor.setAppname(appname);
xxlJobSpringExecutor.setAddress(address);
xxlJobSpringExecutor.setIp(ip);
xxlJobSpringExecutor.setPort(port);
xxlJobSpringExecutor.setAccessToken(accessToken);
xxlJobSpringExecutor.setLogPath(logPath);
xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);
return xxlJobSpringExecutor;
}
我们就可以顺着这个XxlJobSpringExecutor，分析下这个xxl-job-core做了些什么。
2、执行器启动
XxlJobSpringExecutor代码比较简洁，大致框架如下：
public class XxlJobSpringExecutor extends XxlJobExecutor implements ApplicationContextAware, SmartInitializingSingleton, DisposableBean {
@Override
public void afterSingletonsInstantiated() {
// init JobHandler Repository (for method)
initJobHandlerMethodRepository(applicationContext);
// refresh GlueFactory
GlueFactory.refreshInstance(1);
// super start
try {
super.start();
} catch (Exception e) {
throw new RuntimeException(e);
}
}
@Override
public void destroy() {
super.destroy();
}
// ......
}
1、实现了SmartInitializingSingleton接口，在项目启动的时候，会调到afterSingletonsInstantiated方法。这个方法又可以作为进一步阅读的下个入口了；
2、实现了DisposableBean接口，在系统停止的时候，调用destroy方法。
3、实现ApplicationContextAware，只是为了获取applicationContext对象，这个没啥好说的。
先来看看初始化
2.1、解析Xxl-job注解
在使用xxl-job的时候，我们会写@XxlJob注解，来告诉xxl-job这是个定时任务的方法。
那么xxl-job就得解析这个注解并做一系列处理。对吧？
这个事情，就是在afterSingletonsInstantiated方法里面调initJobHandlerMethodRepository去做的。代码略长，就不贴出来了。具体实现逻辑如下：
-
通过applicationContext.getBeanNamesForType获取全部bean
-
遍历所有bean，找到有@XxlJob标记的方法，并判断@XxlJob标记的name值是否有重复，如果重复则报错
-
如果有配置init和destroy方法，则通过反射找到他们
-
将信息组装成MethodJobHandler对象，保存到ConcurrentHashMap中
registJobHandler(name, new MethodJobHandler(bean, executeMethod, initMethod, destroyMethod));
2.2、处理glue模式
一般基于Spring使用的时候，都是bean模式，即
任务以JobHandler方式维护在执行器端；需要结合 "JobHandler" 属性匹配执行器中任务；
而glue模式是指
任务以源码方式维护在调度中心；
这里初始化了一个SpringGlueFactory
2.3、启动
这里调用父类XxlJobExecutor的start方法。方法主要执行下面几个大的步骤：
public class XxlJobExecutor {
...
public void start() throws Exception {
// init logpath
XxlJobFileAppender.initLogPath(logPath);
// init invoker, admin-client
initAdminBizList(adminAddresses, accessToken);
// init JobLogFileCleanThread
JobLogFileCleanThread.getInstance().start(logRetentionDays);
// init TriggerCallbackThread
TriggerCallbackThread.getInstance().start();
// init executor-server
initEmbedServer(address, ip, port, appname, accessToken);
}
...
}
-
初始化执行器日志路径，默认 /data/applogs/xxl-job/jobhandler 。
这个XxlJobFileAppender是个单独写日志文件的工具类。在xxl-job-admin界面上，可以通过界面查看定时任务调度执行的日志。我们在业务代码中，也可以通过XxlJobHelper.log方法，写自己的日志（老版本是XxlJobLogger.log）
-
根据配置的adminAddresses地址，构造AdminBiz列表（后面注册、调服务端接口等，会需要调到这个地址）
-
启动一个daemon线程，每天定期清理调度日志文件（上述1步骤目录下的文件）
-
定义一个LinkedBlockingQueue，这个queue里面放job执行结果。然后启动triggerCallbackThread和triggerRetryCallbackThread 两个线程，向job-admin反馈job执行结果。
这里为啥是2个线程去给admin端反馈执行结果呢？
原来，正常情况下，只有triggerCallbackThread从queue里面拿数据，提交到admin。
但是当它提交失败的时候，triggerCallbackThread就会写一个callbacklog文件。再由triggerRetryCallbackThread读取callbacklog文件，并向admin提交执行结果。
-
构造EmbedServer并启动
构造EmbedServer需要url，这里涉及到三个配置。
### 执行器注册 [选填]：优先使用该配置作为注册地址，为空时使用内嵌服务 ”IP:PORT“ 作为注册地址。从而更灵活的支持容器类型执行器动态IP和动态映射端口问题。 xxl.job.executor.address= ### 执行器IP [选填]：默认为空表示自动获取IP，多网卡时可手动设置指定IP，该IP不会绑定Host仅作为通讯实用；地址信息用于 "执行器注册" 和 "调度中心请求并触发任务"； xxl.job.executor.ip= ### 执行器端口号 [选填]：小于等于0则自动获取；默认端口为9999，单机部署多个执行器时，注意要配置不同执行器端口； xxl.job.executor.port=9999EmbedServer是基于netty实现的一个服务，监听9999端口，并主要响应xxl-job-admin的调度请求。从EmbedHttpServerHandler中可以看出，admin调度中心往执行器发的请求，主要有以下5个：
beat：调度中心检测执行器是否在线时使用 idleBeat：调度中心检测 指定执行器 上 指定任务 是否忙碌（运行中）时使用 （注意这里2个“指定”） run：触发任务执行 kill：终止任务 这里是根据jobId找到对应的jobThread，再改变执行标记后，调interrupt方法。 （所以如果你想优雅地停止一个线程，也可以通过线程标记+interrupt方式） log：查看执行日志执行器什么时候往调用中心注册的呢？
答案是：在EmbedServer的start方法中，启动了一个thread，在其内部调了【startRegistry(appname, address);】
而这行代码里面，又启动了一个registryThread，每30秒注册当前执行器。
至此，xxl-job客户端的逻辑大致分析清楚了，下一节再看看admin的代码
