Browse Source

调度中心与执行器通讯规范为双向restful,方便跨语言,以及第三方执行器实现;通讯组件xxl-rpc方案调整为Jetty+Gson方案;

xuxueli 5 years ago
parent
commit
0e1eb6cbe8

+ 89 - 97
doc/XXL-JOB官方文档.md

@@ -781,7 +781,12 @@ public ReturnT<String> execute(String param) {
 
 - demoJobHandler:简单示例任务,任务内部模拟耗时任务逻辑,用户可在线体验Rolling Log等功能;
 - shardingJobHandler:分片示例任务,任务内部模拟处理分片参数,可参考熟悉分片任务;
-- httpJobHandler:通用HTTP任务Handler;业务方只需要提供HTTP链接等信息即可,不限制语言、平台;
+- httpJobHandler:通用HTTP任务Handler;业务方只需要提供HTTP链接等信息即可,不限制语言、平台。示例任务入参如下:
+    ```
+    url: http://www.xxx.com
+    method: get 或 post
+    data: post-data
+    ```
 - commandJobHandler:通用命令行任务Handler;业务方只需要提供命令行即可;如 “pwd”命令;
 
 
@@ -1024,7 +1029,6 @@ XXL-JOB中“调度模块”和“任务模块”完全解耦,调度模块进
 #### 5.4.4 调度线程池
 调度采用线程池方式实现,避免单线程因阻塞而引起任务调度延迟。
 
-
 #### 5.4.5 并行调度
 XXL-JOB调度模块默认采用并行机制,在多线程调度的情况下,调度模块被阻塞的几率很低,大大提高了调度系统的承载量。
 
@@ -1102,11 +1106,9 @@ xxl-job-admin#com.xxl.job.admin.controller.JobApiController.callback
 
 如若需要支撑更多的任务量,可以通过 "调大调度线程数" 、"降低调度中心与执行器ping延迟" 和 "提升机器配置" 几种方式优化。
 
-#### 5.4.12 均衡调度
-
+#### 5.4.12 均衡调度    
 调度中心在集群部署时会自动进行任务平均分配,触发组件每次获取与线程池数量(调度中心支持自定义调度线程池大小)相关数量的任务,避免大量任务集中在单个调度中心集群节点;
 
-
 ### 5.5 任务 "运行模式" 剖析
 #### 5.5.1 "Bean模式" 任务
 开发步骤:可参考 "章节三" ;
@@ -1116,15 +1118,17 @@ xxl-job-admin#com.xxl.job.admin.controller.JobApiController.callback
 开发步骤:可参考 "章节三" ;
 原理:每个 "GLUE模式(Java)" 任务的代码,实际上是“一个继承自“IJobHandler”的实现类的类代码”,“执行器”接收到“调度中心”的调度请求时,会通过Groovy类加载器加载此代码,实例化成Java对象,同时注入此代码中声明的Spring服务(请确保Glue代码中的服务和类引用在“执行器”项目中存在),然后调用该对象的execute方法,执行任务逻辑。
 
-#### 5.5.3 GLUE模式(Shell) + GLUE模式(Python) + GLUE模式(NodeJS)
+#### 5.5.3 GLUE模式(Shell) + GLUE模式(Python) + GLUE模式(PHP) + GLUE模式(NodeJS) + GLUE模式(Powershell)
 开发步骤:可参考 "章节三" ;
 原理:脚本任务的源码托管在调度中心,脚本逻辑在执行器运行。当触发脚本任务时,执行器会加载脚本源码在执行器机器上生成一份脚本文件,然后通过Java代码调用该脚本;并且实时将脚本输出日志写到任务日志文件中,从而在调度中心可以实时监控脚本运行情况;
 
 目前支持的脚本类型如下:
 
-    - shell脚本:任务运行模式选择为 "GLUE模式(Shell)"时支持 "shell" 脚本任务;
-    - python脚本:任务运行模式选择为 "GLUE模式(Python)"时支持 "python" 脚本任务;
-    - nodejs脚本:务运行模式选择为 "GLUE模式(NodeJS)"时支持 "nodejs" 脚本任务;
+    - shell脚本:任务运行模式选择为 "GLUE模式(Shell)"时支持 "Shell" 脚本任务;
+    - python脚本:任务运行模式选择为 "GLUE模式(Python)"时支持 "Python" 脚本任务;
+    - php脚本:任务运行模式选择为 "GLUE模式(PHP)"时支持 "PHP" 脚本任务;
+    - nodejs脚本:任务运行模式选择为 "GLUE模式(NodeJS)"时支持 "NodeJS" 脚本任务;
+    - powershell:任务运行模式选择为 "GLUE模式(PowerShell)"时支持 "PowerShell" 脚本任务;
 
 脚本任务通过 Exit Code 判断任务执行结果,状态码可参考章节 "5.15 任务执行结果说明";
 
@@ -1208,49 +1212,13 @@ echo "分片总数 total = $3"
 - 设置一:调度中心和执行器,均不设置AccessToken;关闭安全性校验;
 - 设置二:调度中心和执行器,设置了相同的AccessToken;
 
-### 5.11 调度中心API服务
-
-调度中心提供了API服务,主要分为两种类型:
-#### 5.11.1 提供给执行器的API服务:
-    1、任务结果回调服务;
-    2、执行器注册服务;
-    3、执行器注册摘除服务;
-    4、触发任务单次执行服务,支持任务根据业务事件触发;
-    
-API服务位置:com.xxl.job.core.biz.AdminBiz.java  
-API服务请求参考代码:com.xxl.job.adminbiz.AdminBizTest.java
-
-#### 5.11.2 提供给业务的API服务:
-    1、任务列表查询;
-    2、任务新增;
-    3、任务更新;
-    4、任务删除;
-    5、任务启动;
-    6、任务停止;
-    7、任务触发;
-    
-API服务位置:com.xxl.job.admin.controller.JobInfoController.java     
-API服务请求参考代码:可参考任务界面操作的ajax请求。任何ajax接口均可配置成为API服务,只需在待启用的API服务上添加 “@PermissionLimit(limit = false)” 注解取消登录态拦截即可;
-
-### 5.12 执行器API服务
-执行器提供了API服务,供调度中心选择使用,目前提供的API服务有:
-
-    1、心跳检测:调度中心使用
-    2、忙碌检测:调度中心使用
-    3、触发任务执行:调度中心使用;本地进行任务开发时,可使用该API服务模拟触发任务;
-    4、获取Rolling Log:调度中心使用
-    5、终止任务:调度中心使用
-    
-API服务位置:com.xxl.job.core.biz.ExecutorBiz     
-API服务请求参考代码:com.xxl.job.executor.ExecutorBizTest
-
-### 5.13 故障转移 & 失败重试
+### 5.11 故障转移 & 失败重试
 一次完整任务流程包括"调度(调度中心) + 执行(执行器)"两个阶段。
     
 - "故障转移"发生在调度阶段,在执行器集群部署时,如果某一台执行器发生故障,该策略支持自动进行Failover切换到一台正常的执行器机器并且完成调度请求流程。
 - "失败重试"发生在"调度 + 执行"两个阶段,支持通过自定义任务失败重试次数,当任务失败时将会按照预设的失败重试次数主动进行重试;
 
-### 5.14 执行器灰度上线
+### 5.12 执行器灰度上线
 调度中心与业务解耦,只需部署一次后常年不需要维护。但是,执行器中托管运行着业务作业,作业上线和变更需要重启执行器,尤其是Bean模式任务。
 执行器重启可能会中断运行中的任务。但是,XXL-JOB得益于自建执行器与自建注册中心,可以通过灰度上线的方式,避免因重启导致的任务中断的问题。
 
@@ -1260,7 +1228,7 @@ API服务请求参考代码:com.xxl.job.executor.ExecutorBizTest
 - 3、等待B组机器任务运行结束并编译上线;执行器注册地址替换为A组+B组;
 操作结束;
 
-### 5.15 任务执行结果说明
+### 5.13 任务执行结果说明
 系统根据以下标准判断任务执行结果,可参考之。
 
 -- | Bean/Glue(Java) | Glue(Shell) 等脚本任务
@@ -1268,25 +1236,21 @@ API服务请求参考代码:com.xxl.job.executor.ExecutorBizTest
 成功 | IJobHandler.SUCCESS | 0
 失败 | IJobHandler.FAIL | -1(非0状态码)
 
-### 5.16 任务超时控制
+### 5.14 任务超时控制
 支持设置任务超时时间,任务运行超时的情况下,将会主动中断任务;
 
 需要注意的是,任务超时中断时与任务终止机制(可查看“4.9 终止运行中的任务”)类似,也是通过 "interrupt" 中断任务,因此业务代码需要将 "InterruptedException" 外抛,否则功能不可用。
 
-### 5.17 跨平台 & 跨语言
-跨平台、跨语言主要体现在以下两个方面:
-- 1、提供Java、Python、PHP……等十来种任务模式,可参考章节 “5.5 任务 "运行模式" ”;理论上可扩展任意语言任务模式;
-- 2、提供基于HTTP的任务Handler(Bean任务,JobHandler="httpJobHandler");业务方只需要提供HTTP链接等相关信息即可,不限制语言、平台;
-```
-url: http://www.xxx.com
-method: get 或 post
-data: post-data
-```
+### 5.15 跨语言
+XXL-JOB是一个跨语言的任务调度平台,主要体现在如下几个方面:
+- 1、RESTful API:调度中心与执行器之间约定一种基于 restful+json 的通讯协议,并提供相应的API服务。第三方任意语言可据此对接调度中心或者实现执行器。(可参考章节 “调度中心/执行器 RESTful API” )
+- 2、多任务模式:提供Java、Python、PHP……等十来种任务模式,可参考章节 “5.5 任务 "运行模式" ”;理论上可扩展任意语言任务模式;
+- 2、提供基于HTTP的任务Handler(Bean任务,JobHandler="httpJobHandler");业务方只需要提供HTTP链接等相关信息即可,不限制语言、平台;(可参考章节 “原生内置Bean模式任务” )
 
-### 5.18 任务失败告警
+### 5.16 任务失败告警
 默认提供邮件失败告警,可扩展短信、钉钉等方式。如果需要新增一种告警方式,只需要新增一个实现 "com.xxl.job.admin.core.alarm.JobAlarm" 接口的告警实现即可。可以参考默认提供邮箱告警实现 "EmailJobAlarm"。
 
-### 5.19 调度中心Docker镜像构建
+### 5.17 调度中心Docker镜像构建
 可以通过以下命令快速构建调度中心,并启动运行;
 ```
 mvn clean package
@@ -1313,8 +1277,37 @@ XXL-JOB日志主要包含如下两部分,均支持日志自动清理,说明
 针对该问题,调度中心提供内置组件进行处理,逻辑为:调度记录停留在 "运行中" 状态超过10min,且对应执行器心跳注册失败不在线,则将本地调度主动标记失败;
 
 
-## 六、版本更新日志
-### 6.1 版本 V1.1.x,新特性[2015-12-05]
+## 六、调度中心/执行器 RESTful API
+
+### 6.1 调度中心 RESTful API
+
+调度中心提供了API服务,主要分为两种类型:
+#### 5.11.1 提供给执行器的API服务:
+    1、任务结果回调服务;
+    2、执行器注册服务;
+    3、执行器注册摘除服务;
+    4、触发任务单次执行服务,支持任务根据业务事件触发;
+    
+API服务位置:com.xxl.job.core.biz.AdminBiz.java  
+API服务请求参考代码:com.xxl.job.adminbiz.AdminBizTest.java
+
+### 6.2 执行器 RESTful API
+
+### 5.12 执行器API服务
+执行器提供了API服务,供调度中心选择使用,目前提供的API服务有:
+
+    1、心跳检测:调度中心使用
+    2、忙碌检测:调度中心使用
+    3、触发任务执行:调度中心使用;本地进行任务开发时,可使用该API服务模拟触发任务;
+    4、获取Rolling Log:调度中心使用
+    5、终止任务:调度中心使用
+    
+API服务位置:com.xxl.job.core.biz.ExecutorBiz     
+API服务请求参考代码:com.xxl.job.executor.ExecutorBizTest
+
+
+## 七、版本更新日志
+### 7.1 版本 V1.1.x,新特性[2015-12-05]
 **【于V1.1.x版本,XXL-JOB正式应用于我司,内部定制别名为 “Ferrari”,新接入应用推荐使用最新版本】**
 - 1、简单:支持通过Web页面对任务进行CRUD操作,操作简单,一分钟上手;
 - 2、动态:支持动态修改任务状态,动态暂停/恢复任务,即时生效;
@@ -1325,7 +1318,7 @@ XXL-JOB日志主要包含如下两部分,均支持日志自动清理,说明
 - 7、支持自定义参数;
 - 8、支持远程任务执行终止;
 
-### 6.2 版本 V1.2.x,新特性[2016-01-17]
+### 7.2 版本 V1.2.x,新特性[2016-01-17]
 - 1、支持任务分组;
 - 2、支持“本地任务”、“远程任务”;
 - 3、底层通讯支持两种方式,Servlet方式 + JETTY方式;
@@ -1343,7 +1336,7 @@ XXL-JOB日志主要包含如下两部分,均支持日志自动清理,说明
 		- 高扩展性;
 		- 稳定性;
 
-### 6.3 版本 V1.3.0,新特性[2016-05-19]
+### 7.3 版本 V1.3.0,新特性[2016-05-19]
 - 1、遗弃“本地任务”模式,推荐使用“远程任务”,易于系统解耦,任务对应的JobHandler统称为“执行器”;
 - 2、遗弃“servlet”方式底层系统通讯,推荐使用JETTY方式,调度+回调双向通讯,重构通讯逻辑;
 - 3、UI交互优化:左侧菜单展开状态优化,菜单项选中状态优化,任务列表打开表格有压缩优化;
@@ -1353,7 +1346,7 @@ XXL-JOB日志主要包含如下两部分,均支持日志自动清理,说明
 		- BEAN模式执行器:每个执行器都是Spring的一个Bean实例,XXL-JOB通过注解@JobHandler识别和调度执行器;
 		 -GLUE模式执行器:每个执行器对应一段代码,在线Web编辑和维护,动态编译生效,执行器负责加载GLUE代码和执行;
 
-### 6.4 版本 V1.3.1,新特性[2016-05-23]
+### 7.4 版本 V1.3.1,新特性[2016-05-23]
 - 1、更新项目目录结构:
 	- /xxl-job-admin -------------------- 【调度中心】:负责管理调度信息,按照调度配置发出调度请求;
 	- /xxl-job-core ----------------------- 公共依赖
@@ -1363,12 +1356,12 @@ XXL-JOB日志主要包含如下两部分,均支持日志自动清理,说明
 - 2、在新的目录结构上,升级了用户手册;
 - 3、优化了一些交互和UI;
 
-### 6.5 版本 V1.3.2,新特性[2016-05-28]
+### 7.5 版本 V1.3.2,新特性[2016-05-28]
 - 1、调度逻辑进行事务包裹;
 - 2、执行器异步回调执行日志;
 - 3、【重要】在 “调度中心” 支持HA的基础上,扩展执行器的Failover支持,支持配置多执行期地址;
 
-### 6.6 版本 V1.4.0 新特性[2016-07-24]
+### 7.6 版本 V1.4.0 新特性[2016-07-24]
 - 1、任务依赖: 通过事件触发方式实现, 任务执行成功并回调时会主动触发一次子任务的调度, 多个子任务用逗号分隔;
 - 2、执行器底层实现代码进行重度重构, 优化底层建表脚本;
 - 3、执行器中任务线程分组逻辑优化: 之前根据执行器JobHandler进行线程分组,当多个任务复用Jobhanlder会导致相互阻塞。现改为根据调度中心任务进行任务线程分组,任务与任务执行相互隔离;
@@ -1387,7 +1380,7 @@ XXL-JOB日志主要包含如下两部分,均支持日志自动清理,说明
 
 Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段, 地址见分支 [V1.3](https://github.com/xuxueli/xxl-job/tree/v1.3) 。新特性将会在master分支持续更新。
 
-### 6.7 版本 V1.4.1 新特性[2016-09-06]
+### 7.7 版本 V1.4.1 新特性[2016-09-06]
 - 1、项目成功推送maven中央仓库, 中央仓库地址以及依赖如下: 
     ```
     <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
@@ -1405,14 +1398,14 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 7、底层表结构,表明统一大写;
 - 8、调度中心,异常处理器JSON响应的ContentType修改,修复浏览器不识别的问题;
 
-### 6.8 版本 V1.4.2 新特性[2016-09-29]
+### 7.8 版本 V1.4.2 新特性[2016-09-29]
 - 1、推送新版本 V1.4.2 至中央仓库, 大版本 V1.4 进入维护阶段;
 - 2、任务新增时,任务列表偏移问题修复;
 - 3、修复一处因bootstrap不支持模态框重叠而导致的样式错乱的问题, 在任务编辑时会出现该问题;
 - 4、调度超时和Handler匹配不到时,调度状态优化;
 - 5、因catch异常,导致任务不可终止的问题,给出解决方案, 见文档;
 
-### 6.9 版本 V1.5.0 特性[2016-11-13]
+### 7.9 版本 V1.5.0 特性[2016-11-13]
 - 1、任务注册: 执行器会周期性自动注册任务, 调度中心将会自动发现注册的任务并触发执行。
 - 2、"执行器" 新增参数 "AppName" : 是每个执行器集群的唯一标示AppName, 并周期性以AppName为对象进行自动注册。
 - 3、调度中心新增栏目 "执行器管理" : 管理在线的执行器, 通过属性AppName自动发现注册的执行器。只有被管理的执行器才允许被使用;
@@ -1422,14 +1415,14 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 7、表结构调整,底层重构优化;
 - 8、"调度中心"自动注册和发现,failover: 调度中心周期性自动注册, 任务回调时可以感知在线的所有调度中心地址, 通过failover的方式进行任务回调,避免回调单点风险。
 
-### 6.10 版本 V1.5.1 特性[2016-11-13]
+### 7.10 版本 V1.5.1 特性[2016-11-13]
 - 1、底层代码重构和逻辑优化,POM清理以及CleanCode;
 - 2、Servlet/JSP Spec设定为3.0/2.2
 - 3、Spring升级至3.2.17.RELEASE版本;
 - 4、Jetty升级版本至8.2.0.v20160908;
 - 5、已推送V1.5.0和V1.5.1至Maven中央仓库;
 
-### 6.10 版本 V1.5.2 特性[2017-02-28]
+### 7.11 版本 V1.5.2 特性[2017-02-28]
 - 1、IP工具类获取IP逻辑优化,IP静态缓存;
 - 2、执行器、调度中心,均支持自定义注册IP地址;解决机器多网卡时错误网卡注册的情况;
 - 3、任务跨天执行时生成多份日志文件的问题修复;
@@ -1439,7 +1432,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 7、底层代码重构和逻辑优化以及CleanCode;
 - 8、GLUE依赖注入逻辑优化,支持别名注入;
 
-### 6.11 版本 V1.6.0 特性[2017-03-13]
+### 7.12 版本 V1.6.0 特性[2017-03-13]
 - 1、通讯方案升级,原基于HEX的通讯模型调整为基于HTTP的B-RPC的通讯模型;
 - 2、执行器支持手动设置执行地址列表,提供开关切换使用注册地址还是手动设置的地址;
 - 3、执行器路由规则:第一个、最后一个、轮询、随机、一致性HASH、最不经常使用、最近最久未使用、故障转移;
@@ -1450,20 +1443,20 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 8、新建任务默认为非运行状态;
 - 9、GLUE模式任务实例更新逻辑优化,原根据超时时间更新改为根据版本号更新,源码变动版本号加一;
 
-### 6.12 版本 V1.6.1 特性[2017-03-25]
+### 7.13 版本 V1.6.1 特性[2017-03-25]
 - 1、Rolling日志;
 - 2、WebIDE交互重构;
 - 3、通讯增强校验,有效过滤非正常请求;
 - 4、权限增强校验,采用动态登录TOKEN(推荐接入内部SSO);
 - 5、数据库配置优化,解决乱码问题;
 
-### 6.13 版本 V1.6.2 特性[2017-04-25]
+### 7.14 版本 V1.6.2 特性[2017-04-25]
 - 1、运行报表:支持实时查看运行数据,如任务数量、调度次数、执行器数量等;以及调度报表,如调度日期分布图,调度成功分布图等;
 - 2、JobHandler支持设置任务返回值,在任务逻辑中可以方便的控制任务执行结果;
 - 3、资源路径包含空格或中文时资源文件无法加载时,无法准确查看异常信息的问题处理。
 - 4、路由策越优化:循环和LFU路由策略计数器自增无上限问题和首次路由压力集中在首台机器的问题修复;
 
-### 6.14 版本 V1.7.0 特性[2017-05-02]
+### 7.15 版本 V1.7.0 特性[2017-05-02]
 - 1、脚本任务:支持以GLUE模式开发和运行脚本任务,包括Shell、Python和Groovy等类型脚本;
 - 2、新增spring-boot类型执行器example项目;
 - 3、升级jetty版本至9.2;
@@ -1471,7 +1464,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 5、执行器移除GlueLoader依赖,改为推送方式实现,从而GLUE源码加载不再依赖JDBC;
 - 6、登录拦截Redirect时获取项目名,解决非根据目录发布时跳转404问题;
 
-### 6.15 版本 V1.7.1 特性[2017-05-08]
+### 7.16 版本 V1.7.1 特性[2017-05-08]
 - 1、运行日志读写编码统一为UTF-8,解决windows环境下日志乱码问题;
 - 2、通讯超时时间限定为10s,避免异常情况下调度线程占用;
 - 3、执行器,server启动、销毁和注册逻辑调整;
@@ -1481,7 +1474,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 7、弹框组件统一替换为layer;
 - 8、升级quartz版本至2.3.0;
 
-### 6.16 版本 V1.7.2 特性[2017-05-17]
+### 7.17 版本 V1.7.2 特性[2017-05-17]
 - 1、阻塞处理策略:调度过于密集执行器来不及处理时的处理策略,策略包括:单机串行(默认)、丢弃后续调度、覆盖之前调度;
 - 2、失败处理策略;调度失败时的处理策略,策略包括:失败告警(默认)、失败重试;
 - 3、通讯时间戳超时时间调整为180s;
@@ -1489,7 +1482,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 5、执行参数编辑时丢失问题修复;
 - 6、新增任务测试Demo,方便在开发时进行任务逻辑测试;
 
-### 6.17 版本 V1.8.0 特性[2017-07-17]
+### 7.18 版本 V1.8.0 特性[2017-07-17]
 - 1、任务Cron更新逻辑优化,改为rescheduleJob,同时防止cron重复设置;
 - 2、API回调服务失败状态码优化,方便问题排查;
 - 3、XxlJobLogger的日志多参数支持;
@@ -1502,7 +1495,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 10、执行日志,支持根据运行 "状态" 筛选日志;
 - 11、调度中心任务注册检测逻辑优化;
 
-### 6.18 版本 V1.8.1 特性[2017-07-30]
+### 7.19 版本 V1.8.1 特性[2017-07-30]
 - 1、分片广播任务:执行器集群部署时,任务路由策略选择"分片广播"情况下,一次任务调度将会广播触发集群中所有执行器执行一次任务,可根据分片参数处理分片任务;
 - 2、动态分片:分片广播任务以执行器为维度进行分片,支持动态扩容执行器集群从而动态增加分片数量,协同进行业务处理;在进行大数据量业务操作时可显著提升任务处理能力和速度。
 - 3、执行器JobHandler禁止命名冲突;
@@ -1515,7 +1508,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 10、springboot版本执行器,升级至1.5.6.RELEASE版本;
 - 11、统一maven依赖版本管理;
 
-### 6.19 版本 V1.8.2 特性[2017-09-04]
+### 7.20 版本 V1.8.2 特性[2017-09-04]
 - 1、项目主页搭建:提供中英文文档:https://www.xuxueli.com/xxl-job 
 - 2、JFinal执行器Sample示例项目;
 - 3、事件触发:除了"Cron方式"和"任务依赖方式"触发任务执行之外,支持基于事件的触发任务方式。调度中心提供触发任务单次执行的API服务,可根据业务事件灵活触发。
@@ -1527,7 +1520,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 9、调度中心任务监控线程销毁时,批量对失败任务告警,防止告警信息丢失;
 - 10、任务日志文件路径时间戳格式化时SimpleDateFormat并发问题解决;
 
-### 6.20 版本 V1.9.0 特性[2017-12-29]
+### 7.21 版本 V1.9.0 特性[2017-12-29]
 - 1、新增Nutz执行器Sample示例项目;
 - 2、新增任务运行模式 "GLUE模式(NodeJS) ",支持NodeJS脚本任务;
 - 3、脚本任务Shell、Python和Nodejs等支持获取分片参数;
@@ -1560,7 +1553,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 30、任务列表新增筛选条件 "任务描述",快速检索任务;
 - 31、执行器Log文件定期清理功能:执行器新增配置项("xxl.job.executor.logretentiondays")日志保存天数,日志文件过期自动删除。
 
-### 6.21 版本 V1.9.1 特性[2018-02-22]
+### 7.22 版本 V1.9.1 特性[2018-02-22]
 - 1、国际化:调度中心实现国际化,支持中文、英文两种语言,默认为中文。
 - 2、调度报表新增"运行中"中状态项;
 - 3、调度报表优化,报表SQL调优并且新增LocalCache缓存(缓存时间60s),提高大数据量下报表加载速度;
@@ -1570,7 +1563,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 7、修复脚本任务Log文件未正常close的问题;
 - 8、项目依赖全量升级至较新稳定版本,如spring、jackson等等;
 
-### 6.22 版本 V1.9.2 特性[2018-10-05]
+### 7.23 版本 V1.9.2 特性[2018-10-05]
 - 1、任务超时控制:新增任务属性 "任务超时时间",并支持自定义,任务运行超时将会主动中断任务;
 - 2、任务失败重试次数:新增任务属性 "失败重试次数",并支持自定义,当任务失败时将会按照预设的失败重试次数主动进行重试;同时收敛废弃其他失败重试策略,如调度失败、执行失败、状态码失败等;
 - 3、新增任务运行模式 "GLUE模式(PHP) ",支持php脚本任务;
@@ -1613,7 +1606,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 40、项目依赖全量升级至较新稳定版本,如spring、Jackson、groovy等等;
 - 41、docker支持:调度中心提供 Dockerfile 方便快速构建docker镜像; 
 
-### 6.23 版本 V2.0.0 Release Notes[2018-11-04]
+### 7.24 版本 V2.0.0 Release Notes[2018-11-04]
 - 1、调度中心迁移到 springboot;
 - 2、底层通讯组件迁移至 xxl-rpc;
 - 3、容器化:提供官方docker镜像,并实时更新推送dockerhub(docker pull xuxueli/xxl-job-admin),进一步实现产品开箱即用;
@@ -1629,14 +1622,14 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 13、项目依赖升级 groovy 至较新稳定版本;pom清理;
 - 14、子任务失败重试重试逻辑优化,子任务失败时将会按照其预设的失败重试次数主动进行重试
 
-### 6.23 版本 v2.0.1 Release Notes[2018-11-09]
+### 7.25 版本 v2.0.1 Release Notes[2018-11-09]
 - 1、左侧菜单折叠动画问题修复;
 - 2、调度报表日期分布图默认值统一;
 - 3、freemarker对数字默认加千分位问题修复,解决日志ID被分隔导致查看日志失败问题;
 - 4、底层通讯组件升级,修复通讯异常时无效等待的问题;
 - 5、执行器启动之后jetty停止的问题修复;
 
-### 6.24 版本 v2.0.2 Release Notes[2019-04-20]
+### 7.26 版本 v2.0.2 Release Notes[2019-04-20]
 - 1、底层通讯方案优化:升级较新版本xxl-rpc,由"JETTY"方案调整为"NETTY_HTTP"方案,执行器内嵌netty-http-server提供服务,调度中心复用容器端口提供服务;
 - 2、任务告警逻辑调整,改为通过扫描失败日志方式触发。一方面精确扫描失败任务,降低扫描范围;另一方面取消内存队列,降低线程内存消耗;
 - 3、Quartz触发线程池废弃并替换为 "XxlJobThreadPool",降低线程切换、内存占用带来的消耗,提高调度性能;
@@ -1662,7 +1655,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 23、JobHandler#msg长度限制,修复异常情况下日志超长导致内存溢出的问题;
 - 24、升级xxl-rpc至较新版本,修复springboot 2.x版本兼容性问题;
 
-### 6.25 版本 v2.1.0 Release Notes[2019-07-07]
+### 7.27 版本 v2.1.0 Release Notes[2019-07-07]
 - 1、自研调度组件,移除quartz依赖:一方面是为了精简系统降低冗余依赖,另一方面是为了提供系统的可控度与稳定性;
     - 触发:单节点周期性触发,运行事件如delayqueue;
     - 调度:集群竞争,负载方式协同处理,锁竞争-更新触发信息-推送时间轮-锁释放-锁竞争;
@@ -1685,8 +1678,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 18、HttpJobHandler优化,响应数据指定UTF-8格式,避免中文乱码;
 - 19、代码优化,ConcurrentHashMap变量类型改为ConcurrentMap,避免因不同版本实现不同导致的兼容性问题;
 
-
-### 6.26 版本 v2.1.1 Release Notes[2019-11-24]
+### 7.28 版本 v2.1.1 Release Notes[2019-11-24]
 - 1、 调度中心日志自动清理功能(至此,调度中心/执行器均支持日志自动清理,过期天数均默认设置为30天):调度中心新增配置项("xxl.job.logretentiondays")日志保存天数,过期日志自动清理;解决海量日志情况下日志表慢SQL问题;限制大于等于7时生效,否则关闭清理功能,默认为30;
 - 2、 调度报表优化:新增日志报表的存储表,三天内的任务日志会以每分钟一次的频率异步同步至报表中;任务报表仅读取报表数据,极大提升加载速度;
 - 3、 Cron在线生成工具:任务新增、编辑框通过组件在线生成Cron表达式;
@@ -1714,7 +1706,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
 - 25、项目依赖升级至较新稳定版本,如spring、spring-boot、mybatis、slf4j、groovy等等;
 - 26、日志组件优化:调度中心支持控制每次请求最大加载行数,日志量太大时分批请求,避免单次加载日志量太大阻塞页面;
 
-### 6.27 版本 v2.1.2 Release Notes[2019-12-12]
+### 7.29 版本 v2.1.2 Release Notes[2019-12-12]
 - 1、方法任务支持:由原来基于JobHandler类任务开发方式,优化为支持基于方法的任务开发方式;因此,可以支持单个类中开发多个任务方法,进行类复用
 ```
 @XxlJob("demoJobHandler")
@@ -1730,7 +1722,7 @@ public ReturnT<String> execute(String param) {
 - 6、多个项目依赖升级至较新稳定版本;
 - 注意:最新版本 "XxlJobSpringExecutor" 逻辑有调整,历史项目中该组件的配置方式请参考Sample示例项目进行调整,尤其注意需要移除组件的init和destroy方法;
 
-### 6.28 版本 v2.2.0 Release Notes[迭代中]
+### 7.30 版本 v2.2.0 Release Notes[迭代中]
 - 1、调度中心升级springboot2.x;因此,系统要求JDK8+;
 - 2、执行器注册默认值优化;
 - 3、SQL脚本编码默认utf8mb4执行,避免小概率下容器环境中乱码问题;
@@ -1759,7 +1751,7 @@ data: post-data
 - 21、执行备注消息长度限制,修复数据超长无法存储导致导致回调失败的问题;
 - 22、一致性哈希路由策略优化:默认虚拟节点数量调整为100,提高路由的均衡性;
 - 23、调度中心与执行器通讯规范为双向restful,方便跨语言,以及第三方执行器实现;通讯组件xxl-rpc方案调整为Jetty+Gson方案;
-
+注意:XxlJobSpringExecutor组件个别字段调整:“appName” 调整为 “appname” ,升级时该组件时需要注意;
 
 ### TODO LIST
 - 1、任务分片路由:分片采用一致性Hash算法计算出尽量稳定的分片顺序,即使注册机器存在波动也不会引起分批分片顺序大的波动;目前采用IP自然排序,可以满足需求,待定;
@@ -1803,15 +1795,15 @@ data: post-data
 - 28、自定义失败重试时间间隔;
 
 
-## 、其他
+## 、其他
 
-### 7.1 项目贡献
+### 8.1 项目贡献
 欢迎参与项目贡献!比如提交PR修复一个bug,或者新建 [Issue](https://github.com/xuxueli/xxl-job/issues/) 讨论新特性或者变更。
 
-### 7.2 用户接入登记
+### 8.2 用户接入登记
 更多接入的公司,欢迎在 [登记地址](https://github.com/xuxueli/xxl-job/issues/1 ) 登记,登记仅仅为了产品推广。
 
-### 7.3 开源协议和版权
+### 8.3 开源协议和版权
 产品开源免费,并且将持续提供免费的社区技术支持。个人或企业内部可自由的接入和使用。
 
 - Licensed under the GNU General Public License (GPL) v3.

+ 4 - 4
xxl-job-core/src/main/java/com/xxl/job/core/executor/XxlJobExecutor.java

@@ -28,7 +28,7 @@ public class XxlJobExecutor  {
     // ---------------------- param ----------------------
     private String adminAddresses;
     private String accessToken;
-    private String appName;
+    private String appname;
     private String address;
     private String ip;
     private int port;
@@ -41,8 +41,8 @@ public class XxlJobExecutor  {
     public void setAccessToken(String accessToken) {
         this.accessToken = accessToken;
     }
-    public void setAppName(String appName) {
-        this.appName = appName;
+    public void setAppname(String appname) {
+        this.appname = appname;
     }
     public void setAddress(String address) {
         this.address = address;
@@ -78,7 +78,7 @@ public class XxlJobExecutor  {
         TriggerCallbackThread.getInstance().start();
 
         // init executor-server
-        initEmbedServer(address, ip, port, appName, accessToken);
+        initEmbedServer(address, ip, port, appname, accessToken);
     }
     public void destroy(){
         // destory executor-server

+ 4 - 4
xxl-job-core/src/main/java/com/xxl/job/core/server/EmbedServer.java

@@ -35,7 +35,7 @@ public class EmbedServer {
     private ExecutorBiz executorBiz;
     private Thread thread;
 
-    public void start(final String address, final int port, final String appName, final String accessToken) {
+    public void start(final String address, final int port, final String appname, final String accessToken) {
         executorBiz = new ExecutorBizImpl();
         thread = new Thread(new Runnable() {
 
@@ -69,7 +69,7 @@ public class EmbedServer {
                     logger.info(">>>>>>>>>>> xxl-job remoting server start success, nettype = {}, port = {}", EmbedServer.class, port);
 
                     // start registry
-                    startRegistry(appName, address);
+                    startRegistry(appname, address);
 
                     // wait util stop
                     future.channel().closeFuture().sync();
@@ -227,9 +227,9 @@ public class EmbedServer {
 
     // ---------------------- registry ----------------------
 
-    public void startRegistry(final String appName, final String address) {
+    public void startRegistry(final String appname, final String address) {
         // start registry
-        ExecutorRegistryThread.getInstance().start(appName, address);
+        ExecutorRegistryThread.getInstance().start(appname, address);
     }
 
     public void stopRegistry() {

+ 5 - 5
xxl-job-core/src/main/java/com/xxl/job/core/thread/ExecutorRegistryThread.java

@@ -23,11 +23,11 @@ public class ExecutorRegistryThread {
 
     private Thread registryThread;
     private volatile boolean toStop = false;
-    public void start(final String appName, final String address){
+    public void start(final String appname, final String address){
 
         // valid
-        if (appName==null || appName.trim().length()==0) {
-            logger.warn(">>>>>>>>>>> xxl-job, executor registry config fail, appName is null.");
+        if (appname==null || appname.trim().length()==0) {
+            logger.warn(">>>>>>>>>>> xxl-job, executor registry config fail, appname is null.");
             return;
         }
         if (XxlJobExecutor.getAdminBizList() == null) {
@@ -42,7 +42,7 @@ public class ExecutorRegistryThread {
                 // registry
                 while (!toStop) {
                     try {
-                        RegistryParam registryParam = new RegistryParam(RegistryConfig.RegistType.EXECUTOR.name(), appName, address);
+                        RegistryParam registryParam = new RegistryParam(RegistryConfig.RegistType.EXECUTOR.name(), appname, address);
                         for (AdminBiz adminBiz: XxlJobExecutor.getAdminBizList()) {
                             try {
                                 ReturnT<String> registryResult = adminBiz.registry(registryParam);
@@ -78,7 +78,7 @@ public class ExecutorRegistryThread {
 
                 // registry remove
                 try {
-                    RegistryParam registryParam = new RegistryParam(RegistryConfig.RegistType.EXECUTOR.name(), appName, address);
+                    RegistryParam registryParam = new RegistryParam(RegistryConfig.RegistType.EXECUTOR.name(), appname, address);
                     for (AdminBiz adminBiz: XxlJobExecutor.getAdminBizList()) {
                         try {
                             ReturnT<String> registryResult = adminBiz.registryRemove(registryParam);

+ 1 - 1
xxl-job-executor-samples/xxl-job-executor-sample-frameless/src/main/java/com/xuxueli/executor/sample/frameless/config/FrameLessXxlJobConfig.java

@@ -46,7 +46,7 @@ public class FrameLessXxlJobConfig {
         xxlJobExecutor = new XxlJobExecutor();
         xxlJobExecutor.setAdminAddresses(xxlJobProp.getProperty("xxl.job.admin.addresses"));
         xxlJobExecutor.setAccessToken(xxlJobProp.getProperty("xxl.job.accessToken"));
-        xxlJobExecutor.setAppName(xxlJobProp.getProperty("xxl.job.executor.appname"));
+        xxlJobExecutor.setAppname(xxlJobProp.getProperty("xxl.job.executor.appname"));
         xxlJobExecutor.setAddress(xxlJobProp.getProperty("xxl.job.executor.address"));
         xxlJobExecutor.setIp(xxlJobProp.getProperty("xxl.job.executor.ip"));
         xxlJobExecutor.setPort(Integer.valueOf(xxlJobProp.getProperty("xxl.job.executor.port")));

+ 1 - 1
xxl-job-executor-samples/xxl-job-executor-sample-jboot/src/main/java/com/xuxueli/executor/sample/jboot/config/JbootConfig.java

@@ -29,7 +29,7 @@ public class JbootConfig extends JbootAppListenerBase {
         xxlJobExecutor.setAdminAddresses(Jboot.configValue("xxl.job.admin.addresses"));
         xxlJobExecutor.setAccessToken(Jboot.configValue("xxl.job.accessToken"));
         xxlJobExecutor.setAddress(Jboot.configValue("xxl.job.executor.address"));
-        xxlJobExecutor.setAppName(Jboot.configValue("xxl.job.executor.appname"));
+        xxlJobExecutor.setAppname(Jboot.configValue("xxl.job.executor.appname"));
         xxlJobExecutor.setIp(Jboot.configValue("xxl.job.executor.ip"));
         xxlJobExecutor.setPort(Integer.valueOf(Jboot.configValue("xxl.job.executor.port")));
         xxlJobExecutor.setLogPath(Jboot.configValue("xxl.job.executor.logpath"));

+ 1 - 1
xxl-job-executor-samples/xxl-job-executor-sample-jfinal/src/main/java/com/xuxueli/executor/sample/jfinal/config/JFinalCoreConfig.java

@@ -36,7 +36,7 @@ public class JFinalCoreConfig extends JFinalConfig {
 		xxlJobExecutor.setAdminAddresses(xxlJobProp.get("xxl.job.admin.addresses"));
 		xxlJobExecutor.setAccessToken(xxlJobProp.get("xxl.job.accessToken"));
 		xxlJobExecutor.setAddress(xxlJobProp.get("xxl.job.executor.address"));
-		xxlJobExecutor.setAppName(xxlJobProp.get("xxl.job.executor.appname"));
+		xxlJobExecutor.setAppname(xxlJobProp.get("xxl.job.executor.appname"));
 		xxlJobExecutor.setIp(xxlJobProp.get("xxl.job.executor.ip"));
 		xxlJobExecutor.setPort(xxlJobProp.getInt("xxl.job.executor.port"));
 

+ 1 - 1
xxl-job-executor-samples/xxl-job-executor-sample-nutz/src/main/java/com/xuxueli/executor/sample/nutz/config/NutzSetup.java

@@ -37,7 +37,7 @@ public class NutzSetup implements Setup {
 		xxlJobExecutor = new XxlJobExecutor();
 		xxlJobExecutor.setAdminAddresses(xxlJobProp.get("xxl.job.admin.addresses"));
 		xxlJobExecutor.setAccessToken(xxlJobProp.get("xxl.job.accessToken"));
-		xxlJobExecutor.setAppName(xxlJobProp.get("xxl.job.executor.appname"));
+		xxlJobExecutor.setAppname(xxlJobProp.get("xxl.job.executor.appname"));
 		xxlJobExecutor.setAddress(xxlJobProp.get("xxl.job.executor.address"));
 		xxlJobExecutor.setIp(xxlJobProp.get("xxl.job.executor.ip"));
 		xxlJobExecutor.setPort(xxlJobProp.getInt("xxl.job.executor.port"));

+ 1 - 1
xxl-job-executor-samples/xxl-job-executor-sample-spring/src/main/resources/applicationcontext-xxl-job.xml

@@ -28,7 +28,7 @@
 		<!-- 访问令牌[选填],非空则进行匹配校验 -->
 		<property name="accessToken" value="${xxl.job.accessToken}" />
 		<!-- 执行器AppName[选填],为空则关闭自动注册 -->
-		<property name="appName" value="${xxl.job.executor.appname}" />
+		<property name="appname" value="${xxl.job.executor.appname}" />
 		<!-- 注册地址[选填],优先使用该配置作为注册地址,为空时使用内嵌服务 ”IP:PORT“ 作为注册地址 -->
 		<property name="address" value="${xxl.job.executor.address}" />
 		<!-- 执行器IP[选填],为空则自动获取 -->

+ 2 - 2
xxl-job-executor-samples/xxl-job-executor-sample-springboot/src/main/java/com/xxl/job/executor/core/config/XxlJobConfig.java

@@ -23,7 +23,7 @@ public class XxlJobConfig {
     private String accessToken;
 
     @Value("${xxl.job.executor.appname}")
-    private String appName;
+    private String appname;
 
     @Value("${xxl.job.executor.address}")
     private String address;
@@ -46,7 +46,7 @@ public class XxlJobConfig {
         logger.info(">>>>>>>>>>> xxl-job config init.");
         XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
         xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
-        xxlJobSpringExecutor.setAppName(appName);
+        xxlJobSpringExecutor.setAppname(appname);
         xxlJobSpringExecutor.setAddress(address);
         xxlJobSpringExecutor.setIp(ip);
         xxlJobSpringExecutor.setPort(port);