spring boot>>任务调度平台 XXL-JOB

分布式任务调度平台xxl-job是一个开源框架。

GitHub上有详细的源码、文档和demo，文档地址是http://www.xuxueli.com/xxl-job。里面有详细的安装和使用介绍。此博客记录一下思路和安装时遇到的问题。

源码仓库地址 ,直接下载。maven项目导入
https://github.com/xuxueli/xxl-job 
http://git.oschina.net/xuxueli0323/xxl-job

1、配置调度中心

1.1初始化调度数据库

运行mysql脚本(16张表)

/xxl-job/doc/db/tables_xxl_job.sql

1.2 编译源码

解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可

xxl-job-admin：调度中心
xxl-job-core：公共依赖
xxl-job-executor：执行器Sample示例（选择合适的版本执行器，可直接使用，也可以参考其并将现有项目改造成执行器）
    ：xxl-job-executor-sample-spring：Spring版本，通过Spring容器管理执行器，比较通用，推荐这种方式；
    ：xxl-job-executor-sample-springboot：Springboot版本，通过Springboot管理执行器；
    ：xxl-job-executor-sample-jfinal：JFinal版本，通过JFinal管理执行器；
    ：xxl-job-executor-sample-nutz：Nutz版本，通过Nutz管理执行器；

2. 配置部署 执行器项目 

执行器项目通常指 目前开发的项目。在项目中整合xxl-job任务调度框架，只需要引入一个maven包、配置一下参数和实现接口就可以。非常方便。这里记录一下和springboot的集成。引入

<dependency>
    <groupId>com.xuxueli</groupId>
    <artifactId>xxl-job-core</artifactId>
    <version>2.0.1</version>
</dependency>

2.1 application.properties的配置文件 

#xxl-job配置
#调度中心部署跟地址：如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"
xxl.job.admin.addresses=http://192.168.41.26:8070/xxl-job-admin

# xxl-job executor address
#执行器"AppName"和地址信息配置：AppName执行器心跳注册分组依据；地址信息用于"调度中心请求并触发任务"和"执行器注册"。执行器默认端口为9999，
#执行器IP默认为空表示自动获取IP，多网卡时可手动设置指定IP，手动设置IP时将会绑定Host。单机部署多个执行器时，注意要配置不同执行器端口；
xxl.job.executor.appname=my-xxl-job
xxl.job.executor.ip=
xxl.job.executor.port=9999

### xxl-job, access token:执行器通讯TOKEN，非空时启用
xxl.job.accessToken=

### xxl-job log path：执行器运行日志文件存储的磁盘位置，需要对该路径拥有读写权限
xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler
### xxl-job log retention days：执行器Log文件定期清理功能，指定日志保存天数，日志文件过期自动删除。限制至少保持3天，否则功能不生效
xxl.job.executor.logretentiondays=-1

2.2编写XxlJobConfig类

@Log4j
@Configuration
@ComponentScan(basePackages="com.baojian.zhang.task")  //basePackages指向实现了接口IJobHandle的类所在包
public class XxlJobConfig {

	@Value("${xxl.job.admin.addresses}")
    private String addresses;

    @Value("${xxl.job.executor.appname}")
    private String appName;

    @Value("${xxl.job.executor.ip}")
    private String ip;

    @Value("${xxl.job.executor.port}")
    private int port;

    @Value("${xxl.job.executor.logpath}")
    private String logpath;

    @Value("${xxl.job.accessToken}")
    private String accessToken;
    
    @Value("${xxl.job.executor.logretentiondays}")
    private int logRetentionDays;

    @Bean(initMethod = "start", destroyMethod = "destroy")
    public XxlJobSpringExecutor xxlJobExecutor() {
        log.info(">>>>>>>>>>> xxl-job config init.");
        XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
        xxlJobSpringExecutor.setAdminAddresses(addresses);
        xxlJobSpringExecutor.setAppName(appName);
        xxlJobSpringExecutor.setIp(ip);
        xxlJobSpringExecutor.setPort(port);
        xxlJobSpringExecutor.setLogPath(logpath);
        xxlJobSpringExecutor.setAccessToken(accessToken);
        xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);
        return xxlJobSpringExecutor;
    }
}

2.3 编写任务类

@Log4j
@Component
@JobHandler(value="pdaHandler")
public class PdaHandler extends IJobHandler{

	@Override
	public ReturnT<String> execute(String param) throws Exception {
		
		log.info("定时任务测试");
				
		return SUCCESS;
	}

}

启动调度中心和执行器。

出现的错误：

1、错误代码: java.lang.IllegalStateException: unknown code for readObject at 0x3c (<)

解决方法：查看下图 addresses是否为调度中心的正确地址

2、错误代码：RpcResponse byte[] is null

解决方法：不同版本 maven 版本号下对应的 XxlJobConfig类和 PdaHandler的区别