springboot:整合xxl-job

文章目录

  • springboot:整合xxl-job
    • 一、xxl-job介绍
      • 概述
      • 文档地址
      • 源码地址
    • 二、快速入门
      • 初始化数据库
      • 源码介绍
      • 配置调度中心
      • 运行调度中心
      • 配置部署执行器项目
        • maven依赖
        • 执行器配置
        • 日志配置
        • xxlJobConfig
        • DemoJobHandler

项目源码:https://gitee.com/huanglei1111/springboot-demo/tree/master/springboot-xxljob

springboot:整合xxl-job

一、xxl-job介绍

概述

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

文档地址

https://www.xuxueli.com/xxl-job/

源码地址

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

二、快速入门

初始化数据库

去上面的源码地址中找到脚本/xxl-job/doc/db/tables_xxl_job.sql,然后放到数据库中进行执行

源码介绍

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

配置调度中心

调度中心配置内容说明

### 调度中心JDBC链接:链接地址请保持和上面所创建的调度数据库的地址一致
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root_pwd
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
### 报警邮箱
spring.mail.host=smtp.qq.com
spring.mail.port=25
[email protected]
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
### 调度中心通讯TOKEN [选填]:非空时启用;
xxl.job.accessToken=
### 调度中心国际化配置 [必填]: 默认为 "zh_CN"/中文简体, 可选范围为 "zh_CN"/中文简体, "zh_TC"/中文繁体 and "en"/英文;
xxl.job.i18n=zh_CN
## 调度线程池最大线程配置【必填】
xxl.job.triggerpool.fast.max=200
xxl.job.triggerpool.slow.max=100
### 调度中心日志表数据保存天数 [必填]:过期日志自动清理;限制大于等于7时生效,否则, 如-1,关闭自动清理功能;
xxl.job.logretentiondays=30

运行调度中心

调度中心访问地址:http://localhost:8080/xxl-job-admin

默认登录账号 “admin/123456”

配置部署执行器项目

maven依赖

这里的依赖要和上面调度中心的版本一致,我这里都是2.3.0版本的

<dependency>
            <groupId>com.xuxueligroupId>
            <artifactId>xxl-job-coreartifactId>
            <version>2.3.0version>
        dependency>

执行器配置

# 应用名称
spring.application.name=springboot-xxljob
# 服务端口号
server.port=8081
# log config
logging.config=classpath:logback.xml
# 调度中心部署跟地址 [选填]:如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调";为空则关闭自动注册;
xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin
# 执行器AppName [选填]:执行器心跳注册分组依据;为空则关闭自动注册
xxl.job.executor.appname=xxl-job-executor-sample
# 执行器IP [选填]:默认为空表示自动获取IP,多网卡时可手动设置指定IP,该IP不会绑定Host仅作为通讯实用;地址信息用于 "执行器注册" 和 "调度中心请求并触发任务";
xxl.job.executor.ip=
# 执行器端口号 [选填]:小于等于0则自动获取;默认端口为9999,单机部署多个执行器时,注意要配置不同执行器端口;
xxl.job.executor.port=9999
# 执行器通讯TOKEN [选填]:非空时启用;
xxl.job.accessToken=
# 执行器运行日志文件存储磁盘路径 [选填] :需要对该路径拥有读写权限;为空则使用默认路径;
xxl.job.executor.logpath=
# 执行器日志保存天数 [选填] :值大于3时生效,启用执行器Log文件定期清理功能,否则不生效;
xxl.job.executor.logretentiondays=-1

日志配置


<configuration debug="false" scan="true" scanPeriod="1 seconds">

    <contextName>logbackcontextName>
    <property name="log.path" value="/data/applogs/xxl-job/xxl-job-executor-sample-springboot.log"/>

    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} %contextName [%thread] %-5level %logger{36} - %msg%npattern>
        encoder>
    appender>

    <appender name="file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${log.path}file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log.path}.%d{yyyy-MM-dd}.zipfileNamePattern>
        rollingPolicy>
        <encoder>
            <pattern>%date %level [%thread] %logger{36} [%file : %line] %msg%n
            pattern>
        encoder>
    appender>

    <root level="info">
        <appender-ref ref="console"/>
        <appender-ref ref="file"/>
    root>

configuration>

xxlJobConfig

package com.hl.springbootxxljob.config;

import com.xxl.job.core.executor.impl.XxlJobSpringExecutor;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
//指定任务Handler所在包路径
@ComponentScan(basePackages = "com.hl.springbootxxljob.jobhandler")
public class XxlJobConfig {
    private final Logger logger = LoggerFactory.getLogger(XxlJobConfig.class);

    @Value("${xxl.job.admin.addresses}")
    private String adminAddresses;

    @Value("${xxl.job.executor.appname}")
    private String appName;

    @Value("${xxl.job.executor.ip}")
    private String ip;

    @Value("${xxl.job.executor.port}")
    private int port;

    @Value("${xxl.job.accessToken}")
    private String accessToken;

    @Value("${xxl.job.executor.logpath}")
    private String logPath;

    @Value("${xxl.job.executor.logretentiondays}")
    private int logRetentionDays;


    @Bean
    public XxlJobSpringExecutor xxlJobExecutor() {
        logger.info("====xxl-job config init====");
        XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
        xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
        xxlJobSpringExecutor.setAppname(appName);
        xxlJobSpringExecutor.setIp(ip);
        xxlJobSpringExecutor.setPort(port);
        xxlJobSpringExecutor.setAccessToken(accessToken);
        xxlJobSpringExecutor.setLogPath(logPath);
        xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);
        return xxlJobSpringExecutor;
    }

}

DemoJobHandler

2.1.0版本:需要继承"IJobHandler":“com.xxl.job.core.handler.IJobHandler”

​ 注册到执行器工厂:添加“@JobHandler(value=“自定义jobhandler名称”)”

2.3.0版本之后:不需要继承IJobHandler,而且注解也变成@XxlJob

@Component
public class DemoJobHandler{

    @XxlJob("jobDemo")
    public ReturnT<String> jobDemo(String s) throws Exception {
        for (int i = 0; i < 10; i++) {
            System.out.println("excuting......");
            Thread.sleep(2000);
        }
        return SUCCESS;
    }
}

springboot:整合xxl-job_第1张图片

执行器管理中的名字要和执行器项目中的名字一样,如果没有就在执行器管理中新建一个

springboot:整合xxl-job_第2张图片

这里的机器地址是我们自己编写的执行器项目的地址,如果是自动注册格式不为http:/#####/可能会出错

springboot:整合xxl-job_第3张图片

然后在任务管理新建一个任务,我这里是任务2

springboot:整合xxl-job_第4张图片

上图框出来的俩个值需要一样

springboot:整合xxl-job_第5张图片

最后查看日志成功

注意:这里部署容器的时候需要把xxl-job-executor-port 的端口映射出去

你可能感兴趣的:(springboot,java,spring,boot,intellij-idea)