【xx-job】定时任务调度

最新推荐文章于 2024-06-08 18:05:26 发布
最新推荐文章于 2024-06-08 18:05:26 发布
阅读量2.4k 收藏 4
点赞数 1
分类专栏： xx-job 文章标签： java spring boot 笔记 后端 经验分享
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Java_Wxlin/article/details/131554715
版权

XXL-JOB

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

任务调度中心

1、下载XXL-JOB源码

Github

git clone https://github.com/xuxueli/xxl-job.git

Gitee

git clone https://gitee.com/xuxueli0323/xxl-job.git
目录结构说明

  • doc ：XXL-JOB文档（XXL-JOB架构图、XXL-JOB官方文档、数据表初始化脚本、效果截图）

  • xxl-job-admin ：调度中心

  • xxl-job-core ：公共依赖

  • xxl-job-executor-samples ：执行器Sample示例

    • xxl-job-executor-sample-springboot：Springboot版本，通过Springboot管理执行器，推荐这种方式；
    • xxl-job-executor-sample-frameless：无框架版本

2、创建数据库，执行初始化脚本

创建数据库，数据库名称xxl-job。

执行SQL脚本文件，脚本文件位置：xxl-job\doc\db\tables_xxl_job.sql。

库表说明

  • xxl_job_lock ：任务调度锁表；
  • xxl_job_group ：执行器信息表，维护任务执行器信息；
  • xxl_job_info ：调度扩展信息表： 用于保存XXL-JOB调度任务的扩展信息，如任务分组、任务名、机器地址、执行器、执行入参和报警邮件等等；
  • xxl_job_log ：调度日志表： 用于保存XXL-JOB任务调度的历史信息，如调度结果、执行结果、调度入参、调度机器和执行器等等；
  • xxl_job_logglue ：任务GLUE日志：用于保存GLUE更新历史，用于支持GLUE的版本回溯功能；
  • xxl_job_registry ：执行器注册表，维护在线的执行器和调度中心机器地址信息；
  • xxl_job_user ：系统用户表；

3、运行调度中心（xxl-job-admin）。

使用IntelliJ IDEA打开项目xxl-job，修改调度中心配置。

调度中心配置文件地址：

/xxl-job/xxl-job-admin/src/main/resources/application.properties

修改调度中心数据库连接信息：

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=123456

在IntelliJ IDEA中启动项目xxl-job-admin。待启动成功后在浏览器地址栏输入http://localhost:8080/xxl-job-admin 进入任务调度中心登录页面。

输入默认的用户名、密码（admin/123456）登录系统。

4、项目启动

在这里插入图片描述

项目集成

创建SpringBoot 并添加项目依赖

<!-- spring-boot-starter-web (spring-webmvc + tomcat) -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

<!-- xxl-job-core -->
<dependency>
    <groupId>com.xuxueli</groupId>
    <artifactId>xxl-job-core</artifactId>
    <version>${project.parent.version}</version>
</dependency>

编写配置文件

两种配置方式

properties


### xxl-job admin address list, such as "http://address" or "http://address01,http://address02"
xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin

### xxl-job, access token
xxl.job.accessToken=default_token
### xxl-job executor appname
xxl.job.executor.appname=xxl-job-executor-sample
### xxl-job executor registry-address: default use address to registry , otherwise use ip:port if address is null
xxl.job.executor.address=
### xxl-job executor server-info
xxl.job.executor.ip=
xxl.job.executor.port=9999
### xxl-job executor log-path
xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler
### xxl-job executor log-retention-days
xxl.job.executor.logretentiondays=30

yml

# xxl-job配置
xxl:
  job:
    admin:
      # 调度中心部署跟地址 [选填]：如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"；为空则关闭自动注册；
      addresses: http://localhost:8080/xxl-job-admin
    executor:
      # 执行器注册 [选填]：优先使用该配置作为注册地址，为空时使用内嵌服务 ”IP:PORT“ 作为注册地址。从而更灵活的支持容器类型执行器动态IP和动态映射端口问题。
      address:
      # 执行器AppName [选填]：执行器心跳注册分组依据；为空则关闭自动注册
      appname: xxl-job-executor-sample
      # 执行器IP [选填]：默认为空表示自动获取IP，多网卡时可手动设置指定IP，该IP不会绑定Host仅作为通讯实用；地址信息用于 "执行器注册" 和 "调度中心请求并触发任务"；
      ip:
      # 执行器端口号 [选填]：小于等于0则自动获取；默认端口为9999，单机部署多个执行器时，注意要配置不同执行器端口；
      port: 9999
      # 执行器运行日志文件存储磁盘路径 [选填] ：需要对该路径拥有读写权限；为空则使用默认路径；
      logpath: /data/applogs/xxl-job/jobhandler
      # 执行器日志文件保存天数 [选填] ： 过期日志自动清理, 限制值大于等于3时生效; 否则, 如-1, 关闭自动清理功能；
      logretentiondays: 15
    # 执行器通讯TOKEN [选填]：非空时启用；
    accessToken: default_token

注： 这里的appname对应任务调度中心 --> 执行器管理 --> 执行器列表中执行器AppName。

编写配置类


package com.xxl.job.executor.core.config;

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;

/**
 * xxl-job config
 *
 * @author xuxueli 2017-04-28
 */
@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;
    }
}

编写执行器服务类

@Slf4j
@Component
public class XxlJobService {
    /**
     * 1、简单任务示例（Bean模式）
     */
    @XxlJob("demoJobHandler")
    public void demoJobHandler() throws Exception {
        XxlJobHelper.log("XXL-JOB, Hello World.");

        for (int i = 0; i < 5; i++) {
            XxlJobHelper.log("beat at:" + i);
            TimeUnit.SECONDS.sleep(2);
        }
        // default success
    }
}

运行执行器项目。

在这里插入图片描述

测试

新增任务

任务调度中心 --> 任务管理 --> 新增。

在这里插入图片描述

填写完任务信息后点击“保存”按钮。然后在任务列表页面点击任务Row中的“操作”右侧的下拉框，
选择执行一次，再点击“保存”，任务就被执行了一次了。

任务信息属性说明：

  • 任务描述：编写任意内容；
  • Cron：执行器执行时间；
  • 运行模式：这里选的Bean;
  • JobHandler：对应执行器类服务类中@XxlJob(“customJobHandler”)

查看日志

任务调度中心 --> 调度日志。

在这里插入图片描述

执行日志

在这里插入图片描述

四、操作说明

4.1 任务详解-执行器

  • 执行器：任务的绑定的执行器，任务触发调度时将会自动发现注册成功的执行器, 实现任务自动发现功能;

img_5.png

属性说明

属性名称说明
AppName是每个执行器集群的唯一标示AppName, 执行器会周期性以AppName为对象进行自动注册。可通过该配置自动发现注册成功的执行器, 供任务调度时使用;
名称执行器的名称, 因为AppName限制字母数字等组成,可读性不强, 名称为了提高执行器的可读性;
排序执行器的排序, 系统中需要执行器的地方,如任务新增, 将会按照该排序读取可用的执行器列表;
注册方式调度中心获取执行器地址的方式；
机器地址注册方式为"手动录入"时有效，支持人工维护执行器的地址信息；

自动注册和手动注册的区别和配置

img_6.png

  • 自动注册不需要修改任何内容，由系统自己去发现;

  • 手动注册需要自己输入IP地址，用英文的逗号分割;

4.2 任务管理-新增

img_7.png

基础配置

  • 执行器：每个任务必须绑定一个执行器, 方便给任务进行分组;

  • 任务描述：任务的描述信息，便于任务管理;

  • 负责人：任务的负责人;

  • 报警邮件：任务调度失败时邮件通知的邮箱地址，支持配置多邮箱地址，配置多个邮箱地址时用逗号分隔.

调度配置

调度类型：

  • 无：该类型不会主动触发调度；

  • CRON：该类型将会通过CRON，触发任务调度；

  • 固定速度：该类型将会以固定速度，触发任务调度；按照固定的间隔时间，周期性触发；

任务配置

  • 运行模式：

    • BEAN模式：任务以JobHandler方式维护在执行器端；需要结合 “JobHandler” 属性匹配执行器中任务;

  • JobHandler：运行模式为 “BEAN模式” 时生效，对应执行器中新开发的JobHandler类“@JobHandler”注解自定义的value值;

  • 执行参数：任务执行所需的参数.

高级配置

路由策略

img_8.png

当执行器集群部署时，提供丰富的路由策略，包括；

  • FIRST（第一个）：固定选择第一个机器；

  • LAST（最后一个）：固定选择最后一个机器；

  • ROUND（轮询）

    • RANDOM（随机）：随机选择在线的机器；

    • CONSISTENT_HASH（一致性HASH）：每个任务按照Hash算法固定选择某一台机器，且所有任务均匀散列在不同机器上。

    • LEAST_FREQUENTLY_USED（最不经常使用）：使用频率最低的机器优先被选举；

    • LEAST_RECENTLY_USED（最近最久未使用）：最久未使用的机器优先被选举；

    • FAILOVER（故障转移）：按照顺序依次进行心跳检测，第一个心跳检测成功的机器选定为目标执行器并发起调度；

    • BUSYOVER（忙碌转移）：按照顺序依次进行空闲检测，第一个空闲检测成功的机器选定为目标执行器并发起调度；

    • SHARDING_BROADCAST(分片广播)：广播触发对应集群中所有机器执行一次任务，同时系统自动传递分片参数；可根据分片参数开发分片任务；

阻塞处理策略

img_9.png

调度过于密集执行器来不及处理时的处理策略；

  • 单机串行（默认）：调度请求进入单机执行器后，调度请求进入FIFO(First Input First Output)队列并以串行方式运行；

  • 丢弃后续调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，本次请求将会被丢弃并标记为失败；

  • 覆盖之前调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，将会终止运行中的调度任务并清空队列，然后运行本地调度任务

程序员小菜鸡QAQ
关注
  • 1
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
快速学习-XXL-JOB快速入门
逍遥云恋
09-23 1096
二、快速入门 2.1 初始化“调度数据库” 请下载项目源码并解压，获取 “调度数据库初始化SQL脚本” 并执行即可。 “调度数据库初始化SQL脚本” 位置为: /xxl-job/doc/db/tables_xxl_job.sql 调度中心支持集群部署，集群情况下各节点务必连接同一个mysql实例; 如果mysql做主从,调度中心集群节点务必强制走主库; 2.2 编译源码 解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可，源码结构如下： xxl-job-admin：调度中心 xxl
XXL-JOB分布式任务调度系统培训PPT
08-09
XXL-JOB分布式任务调度系统培训PPT
xxljob入门案例与配置
qq_49511498的博客
12-03 2128
使用并配置定时任务
定时任务框架xxl-job(使用、总结)
最新发布
2303_79633394的博客
06-08 3041
任务调度是指系统为了自动完成特定任务，在约定的特定时刻去执行任务的过程。有了任务调度即可解放更多的人力，而是由系统自动去执行任务。某电商系统需要在每天上午10点，下午3点，晚上8点发放一批优惠券。某银行系统需要在信用卡到期还款日的前三天进行短信提醒。某财务系统需要在每天凌晨0:10结算前一天的财务数据，统计汇总。12306会根据车次的不同，设置某几个时间点进行分批放票。如何实现任务调度？多线程方式，结合sleepJDK提供的API，例如：Timer、ScheduledExecutor。
【xxl-job | 第一篇】Java实现定时任务的六种方法
踢桃的成长之路
05-06 1321
Java实现定时任务的六种方法
xxjob分布式定时任务简单入门和改造
u010772230的专栏
03-07 1万+
xxjob简单入门和改造 xxjob简介 XXL-JOB是一个分布式任务调度平台，其核心设计目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产品线，开箱即用。 xxjob官网下载地址 https://www.xuxueli.com/xxl-job/#%E3%80%8A%E5%88%86%E5%B8%83%E5%BC%8F%E4%BB%BB%E5%8A%A1%E8%B0%83%E5%BA%A6%E5%B9%B3%E5%8F%B0XXL-JOB%E3%80%8B xxjob下
XxJob定时任务问题回顾记录
u011602668的博客
11-03 3781
Java web开发的日常工作中，大概率会有定时任务的场景，如果这种需求不多的情况下可以用Spring自带的Scheduled定时任务注解： 如果这种需求较多，写在项目中可能比较混乱，不易管理和迭代，这时可以考虑用XxJob，将任务拆解出来独立成一个服务。XxJob是一个定时任务开源平台，能和Spring程序整合，首先有一个XxJob中心，注册中心登录上去是XxJob可视化面板，可以看到运行报表、任务管理、运行日志，运行日志中可以看到运行的状态，有成功、失败、进行中，服务...
xxl-job源码解析(看这一篇就够了，超简约且详细)
热门推荐
Nuan_Feng的博客
04-12 2万+
服务端启动流程 首先找到配置类 XxlJobAdminConfig 可以发现该类实现 InitializingBean接口，这里直接看 afterPropertiesSet方法即可。 @Override public void afterPropertiesSet() throws Exception { //利用静态声明的只会加载一次的特性，初始化一个单例对象。 adminConfig = this; //初始化xxjob调度器
springboot集成xx-job；
kevin_cat的博客
03-28 1821
AB的定时任务就要在xx-job上个注册。同时AB要配置对应的依赖。所以集成xx-job要分2步骤：第一步：先搭建xx-job服务。xx-job是一个分布式任务管理平台。比如你有AB两个项目。第二步，在A项目中导包并引用。4启动xxjobadmin。
分布式定时任务-XXL-JOB-教程+实战
Roker
02-03 8702
xxl-job确实很强大，功能也很全,经过该文章学习相信你可以把xxl-job给用起来了，但是如果你的项目是一个小体量的单体，我不太建议使用它，Quzrtz或者SpringBoot Task就足够 ，对于xxl-job个人还是有些笨重。
基于Java的xxl-job定时任务调度系统设计源码
05-23
xxl-job是一个基于Java开发的定时任务调度系统，包含287个文件，其中包括135个Java源文件、35个PNG图片文件、35个JavaScript文件、16个XML文件、12个CSS文件、11个FTL模板文件、5个Markdown文件、4个Properties文件...
Elastic-Job分布式任务调度视频教程
11-25
2、课程价值本着从解决生产实际问题出发，讲授分布式任务调度的实现方案，本课程采用当当网开源的Elastic-job任务调度产品作为技术方案，从Elastic-job的应用、原理、项目实战三方面进行讲解，通过学习本课程可以...
xxl-job 任务调度源码包
01-18
xxl-job 任务调度源码包，试了，可以打开管理页面。执行tables_xxl_job.sql 到mysql数据库，配置数据信息就可以打开...运行spring-boot application，打开页面像：http://localhost:8080/xxl-job-admin/ ，就可以进入。
分布式调度任务XXL-JOB架构图
02-11
分布式调度任务XXL-JOB架构图是一种基于quartz调度器的分布式任务调度框架，旨在解决大规模任务的调度和执行问题。下面是该架构图中的关键知识点： 1. 分布式调度中心：XXL-JOB架构图的核心组件是分布式调度中心，...
xxl-job定时任务
m0_49790240的博客
01-27 1万+
xxl-job定时任务的一点分享
xxjob调度成功任务无响应问题
weixin_44770756的博客
03-09 2158
到这里就基本可以确定我们问题出现的原因，应为我的job任务中会有访问其他网址进行检查的情况，其中某一个网址访问的时候会一直等待，这就导致我的任务会一直阻塞，而job又是一分钟执行一次，就出现了大量的任务往队列中写，但是没有线程去消费掉。这里的结果之前是空的，应为我把服务下线之后，xxJob就找不到服务了，所以就会变成失败，通过日志还是可以看到是没有任何报错信息的。我们可以在控制台中设置超时时间，这样我们就不会有很多一直在等待执行中的任务了，就不会去创建大量的任务，导致我们的线程阻塞了。
SpringBoot结合XXL-JOB实现定时任务
xxxzzzqqq_的博客
03-09 1025
篇将介绍 xxl-job 这个定时任务框架。官方说明：XXL-JOB 是一个轻量级分布式任务调度平台，其核心设计目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产品线，开箱即用。通俗来讲：XXL-JOB 是一个任务调度框架，通过引入 XXL-JOB 相关的依赖，按照相关格式撰写代码后，可在其可视化界面进行任务的启动执行中止以及包含了日志记录与查询和任务状态监控。更多详细介绍推荐阅读官方文档。
xxl-job 定时任务
09-13
xxl-job是一个分布式任务调度框架，可以用于实现定时任务的调度和执行。在xxl-job中，定时任务的配置和管理主要涉及到三个部分：xxl-job-admin、执行器组件和定时任务的数据处理。 1. xxl-job-admin是xxl-job的管理后台，可以通过调用com.xxl.job.admin.controller.JobApiController.callback接口来设置定时任务。这个接口可以用于添加、修改、删除定时任务，以及启动、停止定时任务的执行。 2. 执行器组件是用于执行定时任务的组件，其中的配置文件地址为/xxl-job/xxl-job-executor-samples/xxl-job-executor-sample-springboot/src/main/java/com/xxl/job/executor/core/config/XxlJobConfig.java。在这个配置文件中，你可以设置定时任务的一些参数，比如调度线程池大小、任务执行器等。 3. 定时任务的数据处理需要在xxl-job-executor-sample-springboot项目中进行，这是业务代码所在的项目。在这个项目中，你可以使用BEAN模式来设置定时任务。BEAN模式是指通过在类中定义方法并使用@XxlJob注解来标识定时任务，然后在XxlJobConfig.java配置文件中将这个类注册为定时任务。这种方式比较简单，但在官网上没有提供具体的示例。 所以，如果你想使用xxl-job来实现定时任务，你可以先在xxl-job-admin中设置定时任务，然后在执行器组件中配置定时任务的相关参数，最后在xxl-job-executor-sample-springboot项目中使用BEAN模式设置定时任务。这样就能够实现定时任务的调度和执行了。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值