java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > xxl-job定时任务配置

xxl-job定时任务配置应用及添加到springboot项目中实现动态API调用

作者:风楠丶

XXL-JOB是一个分布式任务调度平台,其核心设计目标是开发迅速、学习简单、轻量级、易扩展,本篇文章主要是对xuxueli的xxl-job做一个简单的配置,以及将其添加到自己已有的项目中进行api调用,感兴趣的朋友跟随小编一起看看吧

简介

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

本篇文章主要是对xuxueli的xxl-job做一个简单的配置,以及将其添加到自己已有的项目中进行api调用。

xxl-job的安装与配置

一、xxl-job安装

1、首先访问Gitee克隆/下载xxl-job的源码

https://gitee.com/xuxueli0323/xxl-job

2、下载完解压,在源码文件夹xxl-job-master\xxl-job-master\doc\db里先导入SQL文件到数据库

3、在IDEA中打开下载好的项目文件,使用maven进行编译即可

xxl-job-admin:调度中心
xxl-job-core:公共依赖
xxl-job-executor-samples:执行器Sample示例(选择合适的版本执行器,可直接使用,也可以参考其并将现有项目改造成执行器)
xxl-job-executor-sample-springboot:Springboot版本,通过Springboot管理执行器,推荐这种方式;
xxl-job-executor-sample-frameless:无框架版本;

二、xxl-job的配置

首先配置调度中心

### web
server.port=9527
server.servlet.context-path=/xxl-job-admin
### actuator
management.server.servlet.context-path=/actuator
management.health.mail.enabled=false
### resources
spring.mvc.servlet.load-on-startup=0
spring.mvc.static-path-pattern=/static/**
spring.resources.static-locations=classpath:/static/
### freemarker
spring.freemarker.templateLoaderPath=classpath:/templates/
spring.freemarker.suffix=.ftl
spring.freemarker.charset=UTF-8
spring.freemarker.request-context-attribute=request
spring.freemarker.settings.number_format=0.##########
### mybatis
mybatis.mapper-locations=classpath:/mybatis-mapper/*Mapper.xml
#mybatis.type-aliases-package=com.xxl.job.admin.core.model
### xxl-job, datasource
spring.datasource.url=jdbc:mysql://192.168.3.140:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
### datasource-pool
spring.datasource.type=com.zaxxer.hikari.HikariDataSource
spring.datasource.hikari.minimum-idle=10
spring.datasource.hikari.maximum-pool-size=30
spring.datasource.hikari.auto-commit=true
spring.datasource.hikari.idle-timeout=30000
spring.datasource.hikari.pool-name=HikariCP
spring.datasource.hikari.max-lifetime=900000
spring.datasource.hikari.connection-timeout=10000
spring.datasource.hikari.connection-test-query=SELECT 1
spring.datasource.hikari.validation-timeout=1000
### xxl-job, email
spring.mail.host=smtp.qq.com
spring.mail.port=25
spring.mail.username=xxx@qq.com
spring.mail.from=xxx@qq.com
spring.mail.password=xxx
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
### xxl-job, access token
xxl.job.accessToken=default_token
### xxl-job, i18n (default is zh_CN, and you can choose "zh_CN", "zh_TC" and "en")
xxl.job.i18n=zh_CN
## xxl-job, triggerpool max size
xxl.job.triggerpool.fast.max=200
xxl.job.triggerpool.slow.max=100
### xxl-job, log retention days
xxl.job.logretentiondays=30

这块我设置了任务调度中心的admin端口是9527(端口号可以自定义),spring.datasource.url地址填你导入sql文件的数据库。

接着设置xxl-job-executor-sample-springboot的配置文件

# web port
server.port=9528
# no web
#spring.main.web-environment=false
# log config
logging.config=classpath:logback.xml
### xxl-job admin address list, such as "http://address" or "http://address01,http://address02"
xxl.job.admin.addresses=http://127.0.0.1:9527/xxl-job-admin
### xxl-job, access token
xxl.job.accessToken=default_token
### xxl-job executor appname
xxl.job.executor.appname=test
### 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

xxl-job-executor-sample-springboot端口号为了方便区分我设置了9528(端口号不能与其他端口重复)

到此xxl-job的基本配置就设置好了

三、启动项目

分别启动xxl-job-admin调度中心和xxl-job-executor-sample-springboot的启动命令

打开链接http://localhost:9527/xxl-job-admin/

执行器管理新增执行器

配置执行器时,有几个注意的地方

①执行器的AppName必须与xxl.job.executor.appname保持一致

②这里新增执行器建议手动录入,自动注册可能存在断开连接的问题,机器地址后的端口号要与xxl.job.executor.port端口号保持一致,且要加前缀https://

配置好执行器就可以编写定时任务了

在这里使用xuxueli提供定时任务示例,具体位置如下:

注解中的值就是任务配置中的JobHandler

回到任务调度中心,打开任务管理,执行器选择刚才新建的测试执行器,点击右侧新增任务

这里以BEAN运行模式为例,JobHandler中的值填方法上注解@XxlJob的值,Cron表达式可以根据需求生成,下面贴一个cron的链接,可以根据需要去编写获取,这里以两秒钟执行一次为例,配置完后点击保存。

在线Cron表达式生成器

回到任务管理,找到配置好的任务,点击操作----启动

定时任务就开始启动了,具体效果可以打开IDEA的9528服务看效果

以此xxl-job的安装与配置结束,现在开始引入到我们的springboot项目中

xxl-job添加到已有项目

一、引入POM文件

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

二、编写XxlJob的配置文件

因为上面用过properties了,这里展示一下使用YML来进行配置

xxl:
  job:
    accessToken: default_token
    admin:
      addresses: http://192.168.3.27:9527/xxl-job-admin
    executor:
      appname: fnTest
      address:
      ip:
      port: 9999
      logpath: D:\Work\logs
      logretentiondays: 30

三、编写config配置类

import com.xxl.job.core.executor.impl.XxlJobSpringExecutor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
 * XXL-JOB配置类
 *
 * @author 单程车票
 */
@Slf4j
@Configuration
public class XxlJobConfig {
	@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() {
		log.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;
	}
}

四、配置任务调度

还是需要打开xxl-job-admin任务调度中心服务

这里还是以上文说的9527为例

同样新增执行器

五、编写自己的定时任务

import com.xxl.job.core.biz.model.ReturnT;
import com.xxl.job.core.handler.annotation.XxlJob;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import java.util.Date;
@Component
@Slf4j
public class TestJob {
	@XxlJob("FnHandler")
	public ReturnT<String> wechatActivityJobHandler(String param) {
		log.info(">>>定时任务开始出发<<<param:{}", param);
		log.info(">>>定时任务开始出发<<<param:{}", param);
		log.info(">>>定时任务开始出发<<<param:{}", param);
		log.info(">>>定时任务开始出发<<<param:{}", param);
		log.info(">>>定时任务开始出发<<<param:{}", param);
		log.info(">>>定时任务开始出发<<<param:{}", param);
		log.info(">>>定时任务开始出发<<<param:{}", param);
		return ReturnT.SUCCESS;
	}
}

同样再回到任务调度中心,任务管理---新增任务

JobHandler填写注解@XxlJob中的值,Cron按自身要求编写,保存

执行定时任务

至此,xxl-job已经添加到项目中了,可以去任务调度中心查看任务日志

这篇文章就先分享到这里了,感谢浏览到最后,有问题的话,欢迎大家留言。

到此这篇关于xxl-job定时任务配置应用以及添加到自己已有的springboot项目中实现动态API调用的文章就介绍到这了,更多相关xxl-job定时任务配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文