xxj-job定时任务系统集成（springboot）

最新推荐文章于 2025-03-22 00:03:56 发布

富土康第一亚索

最新推荐文章于 2025-03-22 00:03:56 发布

阅读量2.5k

点赞数

分类专栏： JAVA开发日常文章标签： java

本文链接：https://blog.youkuaiyun.com/u011339397/article/details/109689979

版权

JAVA开发日常专栏收录该内容

4 篇文章

订阅专栏

本文介绍了如何将XxlJob集成到个人的SpringBoot项目中，包括XXL-JOB工程的代码结构、原始项目启动步骤，以及个人项目集成过程。详细讲述了从导入数据库、修改配置、启动项目，到将XxlJob-admin和XxlJob-core集成到项目，再到创建和配置定时任务的整个流程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.xxj-job工程介绍及原始项目启动

1.1 xxl-job代码及结构介绍

个人本次使用的是2.2.0的分支代码。
gitHub地址：https://github.com/xuxueli/xxl-job
在这里插入图片描述
xxl-job本身使用的springboot版本为2.0以上。核心部分包含一个父工程（xxl-job）和两个子工程（xxl-job-admin、xxl-job-core），其他部分（xxl-job-executor-samples）是各个示例工程代码，个人参考springboot版本的示例。

1.2 原始项目启动

（1）在本地mysql，将下载的代码doc文件夹中的sql文件导入数据库；
（2）将xxl-job以maven工程引入idea或eclipse；
（3）修改xxl-job-admin的配置文件，配置好mysql数据库的访问地址及用户名密码，访问端口号可根据需要自行修改；
在这里插入图片描述
注：Mysql数据库5以下：com.mysql.jdbc.Driver
Mysql数据库5以上：com.mysql.cj.jdbc.Driver
（4）运行xxl-job-admin中的main函数，浏览器页面访问
http://localhost:8080/xxl-job-admin，打开登录页面，默认用户名密码admin/123456
在这里插入图片描述

2.个人项目集成xxl-job

个人项目为聚合工程，且使用springboot版本为2.2.6，当前方案是将两个子工程（xxl-job-admin、xxl-job-core）直接集成到原有的项目中。
在这里插入图片描述
（1）修改两个子工程（xxl-job-admin、xxl-job-core）的pom.xml文件，将parent部分修改为个人项目的父工程。

（2）修改父工程的pom.xml，增加两个子工程。

（3）修改完成后，重新引入了当前的聚合工程，启动测试了下xxl-job-admin可以正常登陆。
在这里插入图片描述
（4）下面将project-job工程加入定时任务中。
修改project-job工程的pom.xml文件，增加xxl-job的依赖。

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

==修改properties文件，增加xxl-job的配置 ==

### xxj-job-admin工程的访问地址，执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"；为空则关闭自动注册；such as "http://address" or "http://address01,http://address02"
xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin
### 执行器通讯TOKEN [选填]：非空时启用；
xxl.job.accessToken=
### 执行器的名称，执行器心跳注册分组依据；为空则关闭自动注册
xxl.job.executor.appname=project-job
### xxl-job executor registry-address: default use address to registry , otherwise use ip:port if address is null
xxl.job.executor.address=
### 执行器IP [选填]：默认为空表示自动获取IP，多网卡时可手动设置指定IP
xxl.job.executor.ip=
##  执行器端口号 [选填]：小于等于0则自动获取；默认端口为9999，单机部署多个执行器时，注意要配置不同执行器端口；
xxl.job.executor.port=9999
### 执行器运行日志文件存储磁盘路径 [选填] ：需要对该路径拥有读写权限；为空则使用默认路径；
xxl.job.executor.logpath=/data/applogs/xxl-job/project-job
### 执行器日志保存天数 [选填] ：值大于3时生效，启用执行器Log文件定期清理功能，否则不生效；
xxl.job.executor.logretentiondays=30

（5）首先将原始代码xxl-job-executor-sample-springboot部分的XxlJobConfig.java文件复制到个人project-job工程中。
在这里插入图片描述

（6）project-job工程中新建定时任务类（参考原始代码xxl-job-executor-sample-springboot部分的SampleXxlJob.java）。

（7）启动project-job工程，可以看到项目中xxl-job部分已经成功启动。

（6）管理页面配置注册的定时任务，使用admin登录后点击"执行器管理"—“新建”，填写注册信息。
在这里插入图片描述
保存后，等待执行器注册成功，刷新页面可看到当前注册的机器ip

（7）点击"任务管理"创建定时任务。

执行器选择刚刚注册的执行器，"JobHandler"填写上面第六步代码中注解的部分。点击保存生效。点击操作选择执行一次测试定时任务。
在这里插入图片描述
查看控制台