SpringCloud-搭建XXL-JOB任务调度平台教程

news2024/12/22 15:46:43

一、XXL-JOB任务调度平台介绍

XXL-JOB是一个轻量级分布式任务调度框架，旨在解决分布式系统中的任务调度问题，提高系统的处理效率和任务管理的便捷性。

1. XXL-JOB任务调度概念

XXL-JOB任务调度平台通过中心化管理方式，使得任务的调度更加高效和集中。平台不仅提供了丰富的任务调度功能，例如：CRON表达式、任务依赖、失败重试、任务超时处理、任务分片等，还提供了实时的任务日志、运行结果监控等功能，大大简化了任务调度的复杂性。

2. XXL-JOB任务调度平台架构

XXL-JOB的基本架构主要包括以下几个组成部分：

调度中心（Admin）：负责任务的添加、编辑、删除以及触发任务执行。
执行器（Executor）：负责接受调度中心的命令，执行具体的任务逻辑。

3. XXL-JOB功能

XXL-JOB具有强大且实用的功能，具体如下：

功能	描述
任务调度	支持CRON表达式，动态设置执行频率
任务依赖	支持跨任务依赖，任务链的形式执行
失败处理	支持失败重试机制，自定义重试次数
超时处理	支持任务执行超时设置，超时后自动终止
日志监控	支持实时日志监控，查看任务执行详情
负载均衡	执行器支持集群部署，实现任务负载均衡

二、XXL-JOB搭建流程

搭建XXL-JOB平台涉及到多个步骤，包括环境准备、调度中心的部署、执行器的集成和配置等。

1、环境准备

Java环境：JDK1.8或更高版本。
数据库：MySQL5.5及以上。
Maven：用于项目构建。
可运行的SpringCloud项目。

2、调度中心部署

克隆 XXL-JOB 的代码仓库：

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

导入 doc/db/tables_xxl_job.sql 到 MySQL 数据库，创建所需的数据库和表。

修改调度中心配置文件 application.properties，配置数据库信息。

spring.datasource.url=jdbc:mysql://localhost:3306/xxl_job?Unicode=true&characterEncoding=UTF-8&useSSL=false
spring.datasource.username=root
spring.datasource.password=yourpassword

构建并运行调度中心。
在xxl-job-admin目录下运行以下Maven命令：

mvn clean package -Dmaven.test.skip=true

运行构建好的jar文件：

java -jar xxl-job-admin/target/xxl-job-admin-2.x.x.jar

3、执行器集成

在 SpringCloud 项目的 pom.xml 文件中添加 XXL-JOB 的依赖：

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

配置执行器：
在 application.properties 或 application.yml 中配置执行器信息：

xxl:
  job:
    admin:
      addresses: http://localhost:8080/xxl-job-admin
    executor:
      appname: xxl-job-executor-sample
      address:
      ip:
      port: 9999
      logpath: /data/applogs/xxl-job/jobhandler
      logretentiondays: 30

创建任务执行类：
在 Spring Cloud 项目中创建一个任务类，使用 @XxlJob 注解标记任务执行方法：

import com.xxl.job.core.handler.annotation.XxlJob;
import org.springframework.stereotype.Component;

@Component
public class SampleXxlJob {
    @XxlJob("demoTaskHandler")
    public void demoTaskHandler() throws Exception {
        System.out.println("XXL-JOB, Hello World.");
    }
}

启动Spring Cloud服务，执行器将自动注册到调度中心，并可以在 XXL-JOB 管理员界面添加和触发任务。