Xxl-Job分布式定时任务

火影  金牌会员 | 2024-6-14 23:14:18 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 643|帖子 643|积分 1929

一、简介

XXL-JOB是一个分布式任务调度平台，是一个分布式定时任务的解决方案，作者的名字叫许雪里。
解决问题：在分布式情况下，传统的定时任务，如SpringTask、Timer等，存在定时任务重复执行，无法追踪任务执行结果等，使用Xxl-job可以有效制止在分布式情况下，定时任务出现的各类问题，同时还支持任务结果日志，数据统计，预警邮件等功能。
开源地址：
xxl-job: 一个分布式任务调度平台，其核心计划目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产物线，开箱即用。
GitHub - xuxueli/xxl-job: A distributed task scheduling framework.（分布式任务调度平台XXL-JOB）
源码介绍：
项目源码分为了xxl-job的核心、调度器以及执行器三个部分，在源码中也都有相应的实例，后文也将分别介绍。


二、快速入门

(一) 初始化数据库

需要注意的是，在项目源码中有一个数据库初始化的脚本，在使用之前需要执行此脚本，创建底子的表布局：


  1. - xxl_job_lock：任务调度锁表；
  2. - xxl_job_group：执行器信息表，维护任务执行器信息；
  3. - xxl_job_info：调度扩展信息表： 用于保存XXL-JOB调度任务的扩展信息，如任务分组、任务名、机器地址、执行器、执行入参和报警邮件等等；
  4. - xxl_job_log：调度日志表： 用于保存XXL-JOB任务调度的历史信息，如调度结果、执行结果、调度入参、调度机器和执行器等等；
  5. - xxl_job_logglue：任务GLUE日志：用于保存GLUE更新历史，用于支持GLUE的版本回溯功能；
  6. - xxl_job_registry：执行器注册表，维护在线的执行器和调度中心机器地址信息；
  7. - xxl_job_user：系统用户表；
复制代码
(二) 调度器

调度器，是用于统一管理任务调度平台上调度任务，负责触发调度执行，并且提供任务管理平台。在项目源码中对应为xxl-job-admin，因此我们需要修改xxl-job-admin的配置，以启动调度中心。
  1. ### web
  2. server.port=8888
  3. server.servlet.context-path=/xxl-job-admin
  5. ### actuator
  6. management.server.servlet.context-path=/actuator
  7. management.health.mail.enabled=false
  9. ### resources
  10. spring.mvc.servlet.load-on-startup=0
  11. spring.mvc.static-path-pattern=/static/**
  12. spring.resources.static-locations=classpath:/static/
  14. ### freemarker
  15. spring.freemarker.templateLoaderPath=classpath:/templates/
  16. spring.freemarker.suffix=.ftl
  17. spring.freemarker.charset=UTF-8
  18. spring.freemarker.request-context-attribute=request
  19. spring.freemarker.settings.number_format=0.##########
  21. ### mybatis
  22. mybatis.mapper-locations=classpath:/mybatis-mapper/*Mapper.xml
  23. #mybatis.type-aliases-package=com.xxl.job.admin.core.model
  25. ### xxl-job, datasource
  26. spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?Unicode=true&serverTimezone=Asia/Shanghai&characterEncoding=UTF-8
  27. spring.datasource.username=root
  28. spring.datasource.password=root
  29. spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  31. ### datasource-pool
  32. spring.datasource.type=com.zaxxer.hikari.HikariDataSource
  33. spring.datasource.hikari.minimum-idle=10
  34. spring.datasource.hikari.maximum-pool-size=30
  35. spring.datasource.hikari.auto-commit=true
  36. spring.datasource.hikari.idle-timeout=30000
  37. spring.datasource.hikari.pool-name=HikariCP
  38. spring.datasource.hikari.max-lifetime=900000
  39. spring.datasource.hikari.connection-timeout=10000
  40. spring.datasource.hikari.connection-test-query=SELECT 1
  42. ### xxl-job, email
  43. spring.mail.host=smtp.qq.com
  44. spring.mail.port=25
  45. spring.mail.username=xxx@qq.com
  46. spring.mail.password=xxx
  47. spring.mail.properties.mail.smtp.auth=true
  48. spring.mail.properties.mail.smtp.starttls.enable=true
  49. spring.mail.properties.mail.smtp.starttls.required=true
  50. spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
  52. ### xxl-job, access token
  53. xxl.job.accessToken=
  55. ### xxl-job, i18n (default is zh_CN, and you can choose "zh_CN", "zh_TC" and "en")
  56. xxl.job.i18n=zh_CN
  58. ## xxl-job, triggerpool max size
  59. xxl.job.triggerpool.fast.max=200
  60. xxl.job.triggerpool.slow.max=100
  62. ### xxl-job, log retention days
  63. xxl.job.logretentiondays=30
复制代码
将调度中心的数据库配置修改为我们自己的数据库配置，然后启动调度中心项目，并访问：http://IP:port/xxl-job-admin
初始账号暗码：admin/123456 ， 登录背景之后看到的页面信息如下：


至此，以本地项目标方式启动调度中心就完成了，固然也可以通过docker容器的方式来创建调度中心，这里提供docker下令，以供参考：
  1. version: '3'
  2. services:
  3.   xxl-job:
  4.     image: xuxueli/xxl-job-admin:2.3.0
  5.     container_name: xxl-job
  6.     environment:
  7.       PARAMS: "--spring.datasource.url=jdbc:mysql://ip:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai  --spring.datasource.username=root  --spring.datasource.password=root"
  8.     ports:
  9.       - 8888:8080
  10.     volumes:
  11.       - /data/docker/xxl-job/logs/:/data/applogs/xxl-job/
复制代码
(三) 配置任务

创建完成调度中心之后，先在页面创建一个任务，方便我们后续的测试。在调度中心，任务管理菜单中，可以新建一个任务：


注意：这里新建的任务采用的是默认的示例执行器，假如想要使用自己定义的执行器，需要先在执行器管理中创建执行器，然后为任务分配执行器。
关于表单参数的解释：
任务表单参数

  • 底子配置


  • 执行器：每个任务必须绑定一个执行器, 方便给任务举行分组
  • 任务描述：任务的描述信息，便于任务管理；
  • 负责人：任务的负责人；
  • 报警邮件：任务调度失败时邮件关照的邮箱地址，支持配置多邮箱地址，配置多个邮箱地址时用逗号分隔

  • 调度类型：


  • 无：该类型不会主动触发调度；
  • CRON：该类型将会通过CRON，触发任务调度；
  • 固定速度：该类型将会以固定速度，触发任务调度；按照固定的隔断时间，周期性触发；

  • 任务配置


  • 运行模式：




    • BEAN模式：任务以JobHandler方式维护在执行器端；需要结合 "JobHandler" 属性匹配执行器中任务；
    • JobHandler：运行模式为 "BEAN模式" 时生效，对应执行器中新开发的JobHandler类“@JobHandler”注解自定义的value值；



  • 任务参数：任务执行所需的参数；

  • 壅闭处理处罚策略
壅闭处理处罚策略：调度过于麋集执行器来不及处理处罚时的处理处罚策略；




    • 单机串行（默认）：调度请求进入单机执行器后，调度请求进入FIFO(First Input First Output)队列并以串行方式运行；
    • 丢弃后续调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，本次请求将会被丢弃并标记为失败；
    • 覆盖之前调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，将会终止运行中的调度任务并清空队列，然后运行本地调度任务；


  • 路由策略
当执行器集群摆设时，提供丰富的路由策略，包括；


  • FIRST（第一个）：固定选择第一个呆板；
  • LAST（最后一个）：固定选择最后一个呆板；
  • ROUND（轮询）
  • RANDOM（随机）：随机选择在线的呆板；
  • CONSISTENT_HASH（一致性HASH）：每个任务按照Hash算法固定选择某一台呆板，且所有任务均匀散列在不同呆板上。
  • LEAST_FREQUENTLY_USED（最不经常使用）：使用频率最低的呆板优先被选举；
  • LEAST_RECENTLY_USED（最近最久未使用）：最久未使用的呆板优先被选举；
  • FAILOVER（故障转移）：按照次序依次举行心跳检测，第一个心跳检测乐成的呆板选定为目标执行器并发起调度；
  • BUSYOVER（繁忙转移）：按照次序依次举行空闲检测，第一个空闲检测乐成的呆板选定为目标执行器并发起调度；
  • SHARDING_BROADCAST(分片广播)：广播触发对应集群中所有呆板执行一次任务，同时体系自动传递分片参数；可根据分片参数开发分片任务；
(四) 执行器

执行器，顾名思义是用来执行任务的，在项目中使用执行器，来指定配置的定时任务。以上述配置的示例执行器任务为例，使用如下：

  • 项目中引入依靠
  1. <!--xxl-job-->
  2. <dependency>
  3.   <groupId>com.xuxueli</groupId>
  4.   <artifactId>xxl-job-core</artifactId>
  5.   <version>2.3.0</version>
  6. </dependency>
复制代码

  • 配置调度中心地址信息
  1. # xxl-job配置
  2. xxl:
  3.   job:
  4.     admin:
  5.       addresses: http://127.0.0.1:8090/xxl-job-admin
  6.     accessToken: default_token
  7.     executor:
  8.       appname: xxl-job-executor-sample
  9.       address:
  10.       ip:
  11.       port: 9999
  12.       logpath: ./logs/xxl-job/executor/
  13.       logretentiondays: 30
  14. logging:
  15.   config: classpath:logback.xml
复制代码

  • 添加配置类
  1. import com.xxl.job.core.executor.impl.XxlJobSpringExecutor;
  2. import org.slf4j.Logger;
  3. import org.slf4j.LoggerFactory;
  4. import org.springframework.beans.factory.annotation.Value;
  5. import org.springframework.context.annotation.Bean;
  6. import org.springframework.context.annotation.Configuration;
  8. /**
  9. * xxl-job config
  10. *
  11. * @author xuxueli 2017-04-28
  12. */
  13. @Configuration
  14. public class XxlJobConfig {
  15.     private Logger logger = LoggerFactory.getLogger(XxlJobConfig.class);
  17.     @Value("${xxl.job.admin.addresses}")
  18.     private String adminAddresses;
  20.     @Value("${xxl.job.accessToken}")
  21.     private String accessToken;
  23.     @Value("${xxl.job.executor.appname}")
  24.     private String appname;
  26.     @Value("${xxl.job.executor.address}")
  27.     private String address;
  29.     @Value("${xxl.job.executor.ip}")
  30.     private String ip;
  32.     @Value("${xxl.job.executor.port}")
  33.     private int port;
  35.     @Value("${xxl.job.executor.logpath}")
  36.     private String logPath;
  38.     @Value("${xxl.job.executor.logretentiondays}")
  39.     private int logRetentionDays;
  41.     @Bean
  42.     public XxlJobSpringExecutor xxlJobExecutor() {
  43.         logger.info(">>>>>>>>>>> xxl-job config init.");
  44.         XxlJobSpringExecutor xxlJobSpringExecutor = new XxlJobSpringExecutor();
  45.         xxlJobSpringExecutor.setAdminAddresses(adminAddresses);
  46.         xxlJobSpringExecutor.setAppname(appname);
  47.         xxlJobSpringExecutor.setAddress(address);
  48.         xxlJobSpringExecutor.setIp(ip);
  49.         xxlJobSpringExecutor.setAccessToken(accessToken);
  50.         xxlJobSpringExecutor.setPort(port);
  51.         xxlJobSpringExecutor.setLogPath(logPath);
  52.         xxlJobSpringExecutor.setLogRetentionDays(logRetentionDays);
  53.         return xxlJobSpringExecutor;
  54.     }
  56.     /**
  57.      * 针对多网卡、容器内部署等情况，可借助 "spring-cloud-commons" 提供的 "InetUtils" 组件灵活定制注册IP；
  58.      *
  59.      *      1、引入依赖：
  60.      *          <dependency>
  61.      *             <groupId>org.springframework.cloud</groupId>
  62.      *             <artifactId>spring-cloud-commons</artifactId>
  63.      *             <version>${version}</version>
  64.      *         </dependency>
  65.      *
  66.      *      2、配置文件，或者容器启动变量
  67.      *          spring.cloud.inetutils.preferred-networks: 'xxx.xxx.xxx.'
  68.      *
  69.      *      3、获取IP
  70.      *          String ip_ = inetUtils.findFirstNonLoopbackHostInfo().getIpAddress();
  71.      */
  73. }
复制代码

  • 创建执行器
因为在调度中心中创建任务的时候，指定了任务运行模式为BEAN，并且指定了JobHandler，因此在编写执行器的时候也需要和上述的JobHandler对应。


  1. @Slf4j
  2. @Component
  3. public class HelloJob {
  4.     @XxlJob("demoHandler")
  5.     public void helloJob() {
  6.         log.info("简单任务执行了。。。。");
  7.     }
  8. }
复制代码
创建完成后重启项目，然后进入调度中心查看：

  • 执行器管理


在执行器管理中，自己项目应用已经注册进来了，并且可以或许查看到相应的信息。


以下是执行器的属性阐明：
属性名称
 阐明
AppName
 是每个执行器集群的唯一标示AppName, 执行器会周期性以AppName为对象举行自动注册。可通过该配置自动发现注册乐成的执行器, 供任务调度时使用;
名称
 执行器的名称, 因为AppName限定字母数字等组成,可读性不强, 名称为了提高执行器的可读性;
排序
 执行器的排序, 体系中需要执行器的地方,如任务新增, 将会按照该排序读取可用的执行器列表;
注册方式
 调度中心获取执行器地址的方式；
呆板地址
 注册方式为"手动录入"时有效，支持人工维护执行器的地址信息；
自动注册和手动注册的区别和配置



  • 启动任务
在任务管理中，找到刚刚创建的任务，然后点击启动：


等候状态变为running，这个时候，会到自己的项目查看日志，发现，定时任务开始执行了：


同时，可以在调度日志中看到调度的情况：


至此，关于xxl-job的底子核心功能使用就完成了。
三、任务配置

配置属性详细阐明

  • 底子配置：
  • -执行器：任务的绑定的执行器，任务触发调度时将会自动发现注册乐成的执行器,实现任务自动发现功能;另一方面也可以方便的举行任务分组。每个任务必须绑定一个执行器,可在"执行器管理"举行设置;
  • -任务描述：任务的描述信息，便于任务管理；
  • -负责人：任务的负责人；
  • -报警邮件：任务调度失败时邮件关照的邮箱地址，支持配置多邮箱地址，配置多个邮箱地址时用逗号分隔；
  • 触发配置：
  • -调度类型：
  • 无：该类型不会主动触发调度；
  • CRON：该类型将会通过CRON，触发任务调度；
  • 固定速度：该类型将会以固定速度，触发任务调度；按照固定的隔断时间，周期性触发；
  • 固定延迟：该类型将会以固定延迟，触发任务调度；按照固定的延迟时间，从前次调度结束后开始计算延迟时间，到达延迟时间后触发下次调度；
  • - CRON：触发任务执行的Cron表达式；
  • -固定速度：固定速度的时间隔断，单元为秒；
  • -固定延迟：固定延迟的时间隔断，单元为秒；
  • 任务配置：
  • -运行模式：
  • BEAN模式：任务以JobHandler方式维护在执行器端；需要结合"JobHandler"属性匹配执行器中任务；
  • GLUE模式(Java)：任务以源码方式维护在调度中心；该模式的任务实际上是一段继续自IJobHandler的Java类代码并"groovy"源码方式维护，它在执行器项目中运行，可使用@Resource/@Autowire注入执行器里中的其他服务；
  • GLUE模式(Shell)：任务以源码方式维护在调度中心；该模式的任务实际上是一段"shell"脚本；
  • GLUE模式(Python)：任务以源码方式维护在调度中心；该模式的任务实际上是一段"python"脚本；
  • GLUE模式(PHP)：任务以源码方式维护在调度中心；该模式的任务实际上是一段"php"脚本；
  • GLUE模式(NodeJS)：任务以源码方式维护在调度中心；该模式的任务实际上是一段"nodejs"脚本；
  • GLUE模式(PowerShell)：任务以源码方式维护在调度中心；该模式的任务实际上是一段"owerShell"脚本；
  • -JobHandler：运行模式为"BEAN模式"时生效，对应执行器中新开发的JobHandler类“@JobHandler”注解自定义的value值；
  • -执行参数：任务执行所需的参数；
  • 高级配置：
  • -路由策略：当执行器集群摆设时，提供丰富的路由策略，包括；
  • FIRST（第一个）：固定选择第一个呆板；
  • LAST（最后一个）：固定选择最后一个呆板；
  • ROUND（轮询）：；
  • RANDOM（随机）：随机选择在线的呆板；
  • CONSISTENT_HASH（一致性HASH）：每个任务按照Hash算法固定选择某一台呆板，且所有任务均匀散列在不同呆板上。
  • LEAST_FREQUENTLY_USED（最不经常使用）：使用频率最低的呆板优先被选举；
  • LEAST_RECENTLY_USED（最近最久未使用）：最久未使用的呆板优先被选举；
  • FAILOVER（故障转移）：按照次序依次举行心跳检测，第一个心跳检测乐成的呆板选定为目标执行器并发起调度；
  • BUSYOVER（繁忙转移）：按照次序依次举行空闲检测，第一个空闲检测乐成的呆板选定为目标执行器并发起调度；
  • SHARDING_BROADCAST(分片广播)：广播触发对应集群中所有呆板执行一次任务，同时体系自动传递分片参数；可根据分片参数开发分片任务；
  • -子任务：每个任务都拥有一个唯一的任务ID(任务ID可以从任务列表获取)，当本任务执行结束并且执行乐成时，将会触发子任务ID所对应的任务的一次主动调度。
  • -调度逾期策略：
  • -忽略：调度逾期后，忽略逾期的任务，从当前时间开始重新计算下次触发时间；
  • -立刻执行一次：调度逾期后，立刻执行一次，并从当前时间开始重新计算下次触发时间；
  • -壅闭处理处罚策略：调度过于麋集执行器来不及处理处罚时的处理处罚策略；
  • 单机串行（默认）：调度请求进入单机执行器后，调度请求进入FIFO队列并以串行方式运行；
  • 丢弃后续调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，本次请求将会被丢弃并标记为失败；
  • 覆盖之前调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，将会终止运行中的调度任务并清空队列，然后运行本地调度任务；
  • -任务超时时间：支持自定义任务超时时间，任务运行超时将会主动停止任务；
  • -失败重试次数；支持自定义任务失败重试次数，当任务失败时将会按照预设的失败重试次数主动举行重试
新增任务表单中，任务配置模块主要是运行模式、JobHandler以及任务参数。


(一) 运行模式

这里以Java示例，主要是BEAN和GLUE两种模式
1. BEAN

BEAN模式包罗类情势和方法情势。
一、类情势

Bean模式任务，支持基于类的开发方式，每个任务对应一个Java类。
长处：不限定项目情况，兼容性好。即使是无框架项目，如main方法直接启动的项目也可以提供支持，可以参考示例项目 “xxl-job-executor-sample-frameless”；
缺点：每个任务需要占用一个Java类，造成类的浪费；不支持自动扫描任务并注入到执行器容器，需要手动注入。
示例：

  • 创建BEAN模式的任务



  • 自定义类
自己创建执行类的实现，继续自"com.xxl.job.core.handler.IJobHandler"的JobHandler类，实现此中任务方法。
  1. @Slf4j
  2. public class BeanClassJob extends IJobHandler {
  4.     @Override
  5.     public void execute() throws Exception {
  6.         log.info("BEAN类形式任务执行了，{}", LocalDateTime.now());
  7.     }
  10. }
复制代码

  • 注册
手动注册执行器的实现类
  1. XxlJobExecutor.registJobHandler("beanClassJob", new BeanClassJob());
复制代码
二、方法情势

Bean模式任务，支持基于方法的开发方式，每个任务对应一个方法。
长处：每个任务只需要开发一个方法，并添加”@XxlJob”注解即可，更加方便、快速。支持自动扫描任务并注入到执行器容器。
缺点：略。
基于方法开发的任务，底层会生成JobHandler代理，和基于类的方式一样，任务也会以JobHandler的情势存在于执行器任务容器中。
  1. @Slf4j
  2. @Component
  3. public class HelloJob {
  4.     @XxlJob("demoHandler")
  5.     public void helloJob() {
  6.         log.info("简单任务执行了。。。。");
  7.     }
  8. }
复制代码
这种情势也是寻常我们使用最多的一种情势。
2. GLUE

任务以源码方式维护在调度中心，支持通过Web IDE在线更新，实时编译和生效，因此不需要指定JobHandler。开发流程如下：

  • 新增调度任务
运行模式选中 “GLUE模式(Java)”；



  • 开发任务代码
选中指定任务，点击该任务右侧“GLUE”按钮，将会前往GLUE任务的Web IDE界面，在该界面支持对任务代码举行开发（也可以在IDE中开发完成后，复制粘贴到编辑中）。




版本回溯功能（支持30个版本的版本回溯）：在GLUE任务的Web IDE界面，选择右上角下拉框“版本回溯”，会列出该GLUE的更新汗青，选择相应版本即可表现该版本代码，保存后GLUE代码即回退到对应的汗青版本；


编辑完成后，可以直接点击启动，查看日志：


同时查看控制台打印：


(二) 高级配置

在任务配置的高级配置模块，可以设置路由策略、子任务等等，这块的配置主要是针对分布式的定时任务集群举行配置的，配置后，采用指定的方式选取服务节点执行一次定时任务。在此处的配置中，比较常用的就是路由策略和壅闭处理处罚策略。


1. 路由策略

可以发现路由策略其实是有许多，包括：
● FIRST（第一个）：固定选择第一个呆板；
● LAST（最后一个）：固定选择最后一个呆板；
● ROUND（轮询）
● RANDOM（随机）：随机选择在线的呆板；
● CONSISTENT_HASH（一致性HASH）：每个任务按照Hash算法固定选择某一台呆板，且所有任务均匀散列在不同呆板上。
● LEAST_FREQUENTLY_USED（最不经常使用）：使用频率最低的呆板优先被选举；
● LEAST_RECENTLY_USED（最近最久未使用）：最久未使用的呆板优先被选举；
● FAILOVER（故障转移）：按照次序依次举行心跳检测，第一个心跳检测乐成的呆板选定为目标执行器并发起调度；
● BUSYOVER（繁忙转移）：按照次序依次举行空闲检测，第一个空闲检测乐成的呆板选定为目标执行器并发起调度；
● SHARDING_BROADCAST(分片广播)：广播触发对应集群中所有呆板执行一次任务，同时体系自动传递分片参数；可根据分片参数开发分片任务；


2. 壅闭处理处罚策略

壅闭处理处罚策略：调度过于麋集执行器来不及处理处罚时的处理处罚策略；
● 单机串行（默认）：调度请求进入单机执行器后，调度请求进入FIFO(First Input First Output)队列并以串行方式运行；
● 丢弃后续调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，本次请求将会被丢弃并标记为失败；
● 覆盖之前调度：调度请求进入单机执行器后，发现执行器存在运行的调度任务，将会终止运行中的调度任务并清空队列，然后运行本地调度任务；


四、操纵指南

关于xxl-job还有许多其他的操纵，在这里介绍一下大概用到的操纵。
(一) 用户管理

进入 “用户管理” 界面，可查看和管理用户信息；如今用户分为两种角色：
管理员：拥有全量权限，支持在线管理用户信息，为用户分配权限，权限分配粒度为执行器；
寻常用户：仅拥有被分配权限的执行器，及相干任务的操纵权限；


可以通过新增用户，并为其分配执行器的权限：


使用新用户账号登录


新增用户之后，在新增任务的时候，可以将任务的责任人修改为对应的用户。
(二) 告警邮件

假如定时任务执行失败堕落等，xxl-job可以实现邮件关照的情势来提醒负责人。

  • 配置调度中心
在使用告警邮件之前，需要配置调度中心的邮件发送账号信息，也就是这个邮件用什么账号举行发送，这里需要发送邮件账号开通smtp服务，并获取到授权码，关于这部分可以查看本人之前的邮件发送一问，这里不做赘述。
  1. ### xxl-job, email
  2. spring.mail.host=smtp.qq.com
  3. spring.mail.port=25
  4. spring.mail.username=
  5. spring.mail.from=
  6. spring.mail.password=
  7. spring.mail.properties.mail.smtp.auth=true
  8. spring.mail.properties.mail.smtp.starttls.enable=true
  9. spring.mail.properties.mail.smtp.starttls.required=true
  10. spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
复制代码
在xxl-job-admin调度中心项目中，找到如上配置，修改username、from和password为自己的邮件发送地址。

  • 配置任务
在配置任务的时候，可以执行报警邮件，这里的邮件地址就是接受报警邮件的地址。



  • 测试
配置完成之后，停掉执行器，将调度器重启，然后开启任务，等候调度日志出现失败记载，同时查看接收的邮件信息。


(三) 任务结果

许多时候，定时任务执行，需要手动处理处罚异常和执行结果，比喻代码出现异常，返回执行失败给调度中心，而不是执行乐成。自v1.6.2之后，任务执行结果通过 “IJobHandler” 的返回值 “ReturnT” 举行判断；当返回值符合 “ReturnT.code == ReturnT.SUCCESS_CODE” 时表示任务执行乐成，否则表示任务执行失败，而且可以通过 “ReturnT.msg” 回调错误信息给调度中心；从而，在任务逻辑中可以方便的控制任务执行结果；
  2. /**
  3.      * 任务的执行结果
  4.      */
  5. @XxlJob(value = "taskRunResult", init = "init", destroy = "destroy")
  6. public void taskRunResultExecutor() {
  7.     // 假设在执行这一步的时候出现报错
  8.     if (true) {
  9.         log.error("任务执行报错了！, 异常信息：");
  10.         XxlJobHelper.handleFail("任务执行报错了！");
  11.         return;
  12.     }
  13.     log.info("任务执行成功！");
  14.     XxlJobHelper.handleSuccess("任务执行成功！");
  15. }
  17. public void init() {
  18.     log.info("初始化 定时任务 =====> 准备开始执行定时任务！");
  19. }
  21. public void destroy() {
  22.     log.info("定时任务 执行完成=====> 准备销毁！");
  23. }
复制代码
(四) 访问令牌

为提升体系安全性，调度中心和执行器举行安全性校验，双方AccessToken匹配才允许通讯；调度中心和执行器，可通过配置项 “xxl.job.accessToken” 举行AccessToken的设置。调度中心和执行器，假如需要正常通讯，只有两种设置；
设置一：调度中心和执行器，均不设置AccessToken；关闭安全性校验；
设置二：调度中心和执行器，设置了相同的AccessToken；
一样寻常在生成情况，都需要配置AccessToken，并保证调度中心和执行器使用的是一个AccessToken：
  1. ### xxl-job, access token
  2. xxl.job.accessToken=bf94fac7-de97-4f8d-a3e6-fe8562c480c7
复制代码
  1. # xxl-job配置
  2. xxl:
  3.   job:
  4.     admin:
  5.       addresses: http://127.0.0.1:8090/xxl-job-admin
  6.     accessToken: bf94fac7-de97-4f8d-a3e6-fe8562c480c7
  7.     executor:
  8.       appname: masteryi-xxl-job-executor
  9.       address:
  10.       ip:
  11.       port: 9999
  12.       logpath: ./logs/xxl-job/executor/
  13.       logretentiondays: 30
  14. logging:
  15.   config: classpath:logback.xml
复制代码
五、参考

关于xxl-job的更多用法，可以参考官方开源社区：
分布式任务调度平台XXL-JOB

如有不足，欢迎指正，本文持续更新中。。。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

正序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

火影

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

挺好的 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表