xxljob 引入springboot项目
时间: 2025-05-19 21:25:47 浏览: 16
### 将 XXL-JOB 集成到 SpringBoot 项目中的具体方法
#### 1. 导入依赖
在 `pom.xml` 中引入 `xxl-job-core` 的 Maven 依赖,版本号可以根据需求调整。以下是具体的依赖配置:
```xml
<dependency>
<groupId>com.xuxueli</groupId>
<artifactId>xxl-job-core</artifactId>
<version>2.2.0</version>
</dependency>
```
上述依赖用于支持 XXL-JOB 的核心功能[^1]。
---
#### 2. 数据库初始化
从官方文档提供的 SQL 脚本路径(通常位于 `doc/db/tables_xxl_job.sql`),将其导入 MySQL 或其他兼容数据库中。这一步是为了创建 XXL-JOB 所需的任务表结构[^3]。
---
#### 3. 修改配置文件
编辑 `application.properties` 文件,添加必要的配置项。主要包括以下几个部分:
- **服务端口**
- **数据源连接**
以下是一个完整的示例配置:
```properties
# 端口号
server.port=9090
# 数据库配置
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# XXL-JOB 执行器名称
xxl.job.executor.appname=xxl-job-executor-sample
# 其他可选配置...
```
这些配置定义了应用的服务端口以及与数据库的交互方式[^3]。
---
#### 4. 创建执行器类
编写一个实现 `IExecutorHandler` 接口的 Bean 类,并通过注解标记为组件。例如:
```java
@Component
public class XxlDemoHandler {
@XxlJob("demoJobHandler")
public ReturnT<String> demo(String param) {
try {
// 记录日志
XxlJobHelper.log("参数:" + (param != null ? param : ""));
// 测试逻辑处理
System.out.println("测试开始");
System.out.println(param);
System.out.println("测试完成");
return ReturnT.SUCCESS;
} catch (Exception e) {
logger.error(e.getMessage(), e);
return new ReturnT<>(ReturnT.FAIL_CODE, e.toString());
}
}
}
```
该代码片段展示了如何注册一个简单的任务处理器[^4]。
---
#### 5. 注册执行器
登录 XXL-JOB 控制台,在“执行器管理”页面新增一条记录,填写如下字段:
- **AppName**: 对应于 `application.properties` 中的 `xxl.job.executor.appname` 属性值。
- **地址列表**: 如果本地运行,则可以填入默认值 `http://localhost:9090/xxl-job-admin`.
完成后保存并启动您的 Spring Boot 应用程序。
---
### 总结
以上步骤涵盖了从环境搭建到任务编写的全过程。按照此流程操作后,您应该能够成功将 XXL-JOB 集成至 Spring Boot 项目中,并具备基本的任务调度能力。
---
阅读全文
相关推荐


















