update document

This commit is contained in:
xuxueli 2019-12-12 13:07:30 +08:00
parent a1900b4dc2
commit 59244ec459
1 changed files with 28 additions and 12 deletions

View File

@ -686,18 +686,34 @@ public XxlJobSpringExecutor xxlJobExecutor() {
- 负责人:任务的负责人; - 负责人:任务的负责人;
- 执行参数:任务执行所需的参数; - 执行参数:任务执行所需的参数;
### 3.1 BEAN模式
BEAN模式有两种开发方式 ### 3.1 BEAN模式类形式
- 1、基于类的方式早期提供的方式需要开发一个继承自"com.xxl.job.core.handler.IJobHandler"的JobHandler类。新版本已经不提供这种方式的任务自动注入支持需要手动通过如下方式注入到执行器容器。方式比较原始
```
XxlJobExecutor.registJobHandler("demoJobHandler", new DemoJobHandler());
```
- 2、基于方法的方式新版本提供也是推荐的方式只需要在相关任务方法上添加"@XxlJob"注解即可,会自动完成任务注入到执行器容器。更加方便、高效;
>注意上面两种方式开发的任务底层都会生成JobHandler代理因此任务都会以JobHandler的形式存在于执行器任务容器中 基于类的Bean模式开发方式这是比较原始的一种开发方式。
基于方法的方式,开发步骤如下: - 优点兼容性好、不限制项目环境即使是无框架项目如main方法直接启动的项目也可以提供支持可以参考示例项目 "xxl-job-executor-sample-frameless"
- 缺点每个任务需要占用一个Java类比较浪费资源而且不支持自动扫描任务注入到执行器容器需要手动注入。
#### 步骤一执行器项目中开发Job类
- 1、开发一个继承自"com.xxl.job.core.handler.IJobHandler"的JobHandler类。
- 2、手动通过如下方式注入到执行器容器。
```
XxlJobExecutor.registJobHandler("demoJobHandler", new DemoJobHandler());
```
#### 步骤二:调度中心,新建调度任务
后续步骤和 "3.2 BEAN模式方法形式"一致,可以前往参考。
### 3.2 BEAN模式方法形式
基于方法的Bean模式开发方式这是比较推荐的开发方式。
- 优点:每个任务只需要开发一个方法,添加"@XxlJob"注解即可。更加方便、快速。会自动扫描任务注入到执行器容器。
- 缺点要求Spring容器环境
>基于方法开发的任务底层会生成JobHandler代理和基于类的方式一样任务也会以JobHandler的形式存在于执行器任务容器中。
#### 步骤一执行器项目中开发Job方法 #### 步骤一执行器项目中开发Job方法
@ -729,7 +745,7 @@ public ReturnT<String> execute(String param) {
- commandJobHandler通用命令行任务Handler业务方只需要提供命令行即可如 “pwd”命令 - commandJobHandler通用命令行任务Handler业务方只需要提供命令行即可如 “pwd”命令
### 3.2 GLUE模式(Java) ### 3.3 GLUE模式(Java)
任务以源码方式维护在调度中心支持通过Web IDE在线更新实时编译和生效因此不需要指定JobHandler。开发流程如下 任务以源码方式维护在调度中心支持通过Web IDE在线更新实时编译和生效因此不需要指定JobHandler。开发流程如下
#### 步骤一:调度中心,新建调度任务: #### 步骤一:调度中心,新建调度任务:
@ -744,7 +760,7 @@ public ReturnT<String> execute(String param) {
![输入图片说明](https://www.xuxueli.com/doc/static/xxl-job/images/img_dNUJ.png "在这里输入图片标题") ![输入图片说明](https://www.xuxueli.com/doc/static/xxl-job/images/img_dNUJ.png "在这里输入图片标题")
### 3.3 GLUE模式(Shell) ### 3.4 GLUE模式(Shell)
#### 步骤一:调度中心,新建调度任务 #### 步骤一:调度中心,新建调度任务
参考上文“配置属性详细说明”对新建的任务进行参数配置,运行模式选中 "GLUE模式(Shell)" 参考上文“配置属性详细说明”对新建的任务进行参数配置,运行模式选中 "GLUE模式(Shell)"
@ -819,7 +835,7 @@ public ReturnT<String> execute(String param) {
该操作仅针对GLUE任务。 该操作仅针对GLUE任务。
选中指定任务点击该任务右侧“GLUE”按钮将会前往GLUE任务的Web IDE界面在该界面支持对任务代码进行开发。可参考章节 "3.2 GLUE模式(Java)"。 选中指定任务点击该任务右侧“GLUE”按钮将会前往GLUE任务的Web IDE界面在该界面支持对任务代码进行开发。可参考章节 "3.3 GLUE模式(Java)"。
### 4.5 启动/停止任务 ### 4.5 启动/停止任务
可对任务进行“启动”和“停止”操作。 可对任务进行“启动”和“停止”操作。