1、入门和集成

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

搭建控制台 

XXL-JOB-ADMIN jar 本地启动,然后初始化调度平台的SQL tables_xxl_job.sql

image

登录地址如下 http://localhost:8080/xxl-job-admin/toLogin

用户名:admin  密码 123456

image

 

集成SpringBoot 配置如下:

image

 @Bean
    public XxlJobSpringExecutor xxlJobExecutor() {
        logger.info(">>>>>>>>>>> xxl-job config init.");
        // 配置sprngboot 执行器
        XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
        // 调度地址
        xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
        // 执行器名称
        xxlJobSpringExecutor.setAppname(appname);
        // 执行器地址
        xxlJobSpringExecutor.setAddress(address);
        // 执行器IP
        xxlJobSpringExecutor.setIp(ip);
        // 执行器端口
        xxlJobSpringExecutor.setPort(port);
        // accessToken
        xxlJobSpringExecutor.setAccessToken(accessToken);
        // 调度超时时间
        xxlJobSpringExecutor.setTimeout(timeout);
        // 日志文件存储路径
        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();
     */

 

  /**
     * 分片广播任务
     */
    @XxlJob("shardingJobHandler")
    public void shardingJobHandler() throws Exception {

        // 分片参数
        int shardIndex = XxlJobHelper.getShardIndex();
        int shardTotal = XxlJobHelper.getShardTotal();

        XxlJobHelper.log("分片参数:当前分片序号 = {}, 总分片数 = {}", shardIndex, shardTotal);

        // 业务逻辑
        for (int i = 0; i < shardTotal; i++) {
            if (i == shardIndex) {
                XxlJobHelper.log("第 {} 片, 命中分片开始处理", i);
            } else {
                XxlJobHelper.log("第 {} 片, 忽略", i);
            }
        }

    }

启动Springboot 项目。

在调度平台配置任务如下: 

image

 

image

 执行日志结果如下:

image

 

也可以从页面的调度日志查看

image

 

 

分析一个日志知识点

从源码追踪分析如下:

image

如果不配置路径则默认是输出到 logger 中。

 当我修改日志配置发现并不能生效。

image

追踪源码效果如下:

image

image

image

image

 

XXL-JOB会为每次调度请求生成一个单独的日志文件,需要通过 “XxlJobHelper.log” 打印执行日志,“调度中心”查看执行日志时将会加载对应的日志文件。

(历史版本通过重写LOG4J的Appender实现,存在依赖限制,该方式在新版本已经被抛弃)

日志文件存放的位置可在“执行器”配置文件进行自定义,默认目录格式为:/data/applogs/xxl-job/jobhandler/“格式化日期”/“数据库调度日志记录的主键ID.log”。

 

 posted on 2025-09-17 20:11  会写点代码的黄二  阅读(21)  评论(0)    收藏  举报