最详细的xxl-job java配置方式spring-boot

转自：https://blog.csdn.net/weixin_44055234/article/details/106565516

————XXL-JOB*是一个轻量级分布式任务调度平台，其核心设计目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产品线，开箱即用。且支持线上编写调度任务。
如何集成？

去gitee或者github下载源代码 goto xxl-job

1. 下载或者克隆后用idea 打开项目或直接用idea克隆项目到本地

2. 在项目的doc文件夹下有个db文件夹 ，db文件夹下的sql脚本是xxl-job运行最基本的数据库和表，用sqlyol或Navicat
   运行脚本，或者其他方式执行sql脚本

3. 在xxl-job-admin项目中的application.properties中配置相关属性
   xxl-job-admin是调度器 所以得先启动，如果执行器启动找不到调度器会报连接异常
   

    把刚刚执行sql脚本的数据库连接和密码配置到application.properties中
    其他属性可有所需求在进行配置
   

4. 等待idea自动导包完成 然后使用maven工具 先把项目clear 在install 或者xxl-job-admin这个模块需要的模块 和调度模块需要的模块 install
   install 后jar包会存在自己的本地仓库，之后可以直接引入

5. 找到xxl-job的启动类 启动项目，或者直接打包成jar包 运行也可以
   启动成功后浏览器访问 http://127.0.0.1:8080/xxl-job-admin 就可以看到登录页面
   默认账号密码是 admin 123456

登录后
因为之前有测试过所以有数据

如何使用？ 编写执行器
6. 新建spring boot 工程 在pom文件中导入坐标

 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>com.xuxueli</groupId> <artifactId>xxl-job-core</artifactId> <version>2.2.1-SNAPSHOT</version> </dependency> 

这两个坐标是必须的 如果没有spring-boot-starter-web 会无法启动

8. 编写application.properties中的配置还有logback.xml复制到resources下，这个文件可以自己编写，为了方便我是从xxl-job-admin模块下resources文件中拷贝过来的
   
9. 编写配置类来读取application.properties的配置
   这里我是直接复制xxl-job-admin的配置类

import com.xxl.job.core.executor.impl.XxlJobSpringExecutor; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class XXLJobConfig { private Logger logger = LoggerFactory.getLogger(XXLJobConfig.class); @Value("${xxl.job.admin.addresses}") private String adminAddresses; @Value("${xxl.job.accessToken}") private String accessToken; @Value("${xxl.job.executor.appname}") private String appname; @Value("${xxl.job.executor.address}") private String address; @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.executor.logretentiondays}") private int logRetentionDays; @Bean public XxlJobSpringExecutor xxlJobExecutor() { logger.info(">>>>>>>>>>> xxl-job config init."); 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; } /** * 针对多网卡、容器内部署等情况，可借助 "spring-cloud-commons" 提供的 "InetUtils" 组件灵活定制注册IP； * * 1、引入依赖： * <dependency> * <groupId>org.springframework.cloud</groupId> * <artifactId>spring-cloud-commons</artifactId> * <version>${version}</version> * </dependency> * * 2、配置文件，或者容器启动变量 * spring.cloud.inetutils.preferred-networks: 'xxx.xxx.xxx.' * * 3、获取IP * String ip_ = inetUtils.findFirstNonLoopbackHostInfo().getIpAddress(); */ } 

10. 编写需要定时执行的代码，也就是调度器执行的执行器
    在需要执行的方法加上@XxlJob 注解 并且取名，之后在调度器中好区分，否者无法调度
    注：Returnt<>(200,"…")中 code 200是成功

11. 配置完毕后启动我们自己创建的工程，在此之前必须启动xxl-job-admin 否者会报错
    在xxl-job-admin的管理页面新增执行器，执行器管理->新增->填写相关信息
    appname是之前在我们自己工程里application.properties配置的
    名称可随便取，只是个区分
    机器地址可手动填写多个，可做高可用
    如果你的执行器是多个的话他会用appName来区分，多个执行器介意手动填写

12. 在任务管理中找到刚刚创建的执行器，选中- 新增
    
    
    任务参数会传递到执行器中
    其他参数见名知意

详情可查阅官方文档

13. 创建好任务后可在点击操作任务，点启动后执行器就会执行

配置任务的时候如果运行模式是GLUE 可以在线编写调度器代码和脚本，支持多语言
运行后可在运行报表中查看调度情况，也可以查看调度日志

调度器集群
一个调度器在执行另外一个不会干涉