###
XXL-Job 分布式任务调度平台使用指南
XXL-JOB 是一个轻量级的分布式任务调度框架，由大众点评员工徐雪里于2015年发布[^1]。其核心设计目标是开发迅速、学习简单、轻量级和易扩展。以下是关于
XXL-JOB 的安装、配置及使用方法的详细指南。
---
#### 1. 下载与安装
XXL-JOB 提供了管理后台和执行器两个部分。需要分别下载并配置它们。
- **下载地址**: 官方地址为 [https://www.xuxueli.com/
xxl-job/](https://www.xuxueli.com/
xxl-job/)。
- **步骤**:
- 下载
XXL-JOB 源码或二进制包。
- 确保本地已安装 JDK (推荐版本为 1.8 或以上) 和 Maven。
- 构建项目：运行以下命令以生成可执行文件。
```bash
mvn clean install
-DskipTests
```
---
#### 2. 数据库配置
XXL-JOB 使用数据库存储任务信息和其他元数据。需要手动创建数据库并初始化表结构。
- **数据库初始化**:
- 在官方文档中提供了 SQL 脚本，用于创建所需的表结构。
- 将脚本导入到 MySQL 数据库中。
- **修改配置文件**:
- 编辑 `admin` 模块中的 `application.properties` 文件，设置数据库连接信息。
```properties
spring.datasource.driver
-class
-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/
xxl_
job?useUnicode=true&characterEncoding=UTF
-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=123456
```
---
#### 3. 配置 Admin 管理后台
Admin 是
XXL-JOB 的管理界面，负责任务的调度和监控。
- **启动 Admin**:
- 进入 `
xxl-job-admin` 目录，运行以下命令启动服务：
```bash
java
-jar
xxl-job-admin.jar
```
- 默认访问地址为 `http://localhost:8080`，登录用户名为 `admin`，密码为 `123456`。
---
#### 4. 配置执行器
执行器是实际运行任务的模块，需要与 Admin 进行通信。
- **添加依赖**:
在项目的 `pom.xml` 文件中添加以下依赖：
```xml
<dependency>
<groupId>com.xuxueli</groupId>
<artifactId>
xxl-job-core</artifactId>
<version>2.3.0</version>
</dependency>
```
- **配置执行器**:
编辑 `application.yml` 文件，配置执行器相关信息：
```yaml
xxl:
job:
admin:
addresses: http://127.0.0.1:8080/
xxl-job-admin
executor:
appname: demoExecutor
ip:
port: 9999
logpath: ./
jobhandler.log
logretentiondays: 30
```
- **编写任务代码**:
创建一个任务类，并实现 `I
JobHandler` 接口：
```java
import com.
xxl.
job.core.handler.I
JobHandler;
import com.
xxl.
job.core.handler.annotation.
XxlJob;
@
XxlJob("demo
JobHandler")
public class Demo
JobHandler extends I
JobHandler {
@Override
public void execute() throws Exception {
System.out.println("任务执行成功！");
}
}
```
---
#### 5. 创建与运行任务
在 Admin 管理后台中创建任务，并绑定到对应的执行器。
- **任务类型**:
支持多种任务类型，包括 Cron 表达式、固定延迟、固定频率等。
- **Cron 表达式**:
Cron 表达式用于定义任务的执行时间规则。例如，`0 0/1 * * * ?` 表示每分钟执行一次[^2]。
---
#### 6. 原理概述
XXL-JOB 的核心原理基于 Zookeeper 和 Quartz，支持分布式环境下的任务调度[^4]。主要特点包括：
- **高可用性**: 支持多节点部署，确保任务不因单点故障而中断。
- **弹性扩容**: 动态调整执行器数量以适应任务负载变化。
- **失效转移**: 当某个执行器不可用时，任务会自动转移到其他可用执行器上。
---
#### 7. 其他注意事项
- **日志管理**: 执行器的日志路径由 `logpath` 参数指定，默认保留 30 天。
- **权限控制**: Admin 提供用户角色管理功能，可根据需求分配不同权限。
- **监控与告警**: 支持通过邮件或其他方式发送任务执行状态的通知。
---
扫一扫
987
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
