您的位置:首页 > 编程语言 > Java开发

SpringBoot+Quartz实现动态配置定时任务

2018-10-10 16:27 621 查看
版权声明: https://blog.csdn.net/typ1805/article/details/82998351

一、Quartz简介

了解 Quartz 

  • Quartz 是一个完全由 Java 编写的开源作业调度框架,为在 Java 应用程序中进行作业调度提供了简单却强大的机制。
  • Quartz 可以与 J2EE 与 J2SE 应用程序相结合也可以单独使用。
  • Quartz 允许程序开发人员根据时间的间隔来调度作业。
  • Quartz 实现了作业和触发器的多对多的关系,还能把多个作业与不同的触发器关联。

Quartz 核心概念

  • Job 表示一个工作,要执行的具体内容。此接口中只有一个方法,如下:void execute(JobExecutionContext context)
  • JobDetail 表示一个具体的可执行的调度程序,Job 是这个可执行程调度程序所要执行的内容,另外 JobDetail 还包含了这个任务调度的方案和策略。 
  • Trigger 代表一个调度参数的配置,什么时候去调。 
  • Scheduler 代表一个调度容器,一个调度容器中可以注册多个 JobDetail 和 Trigger。当 Trigger 与 JobDetail 组合,就可以被 Scheduler 容器调度了。

集群Quartz应用

  • 伸缩性
  • 高可用性
  • 负载均衡
  • Quartz可以借助关系数据库和JDBC作业存储支持集群。
  • Terracotta扩展quartz提供集群功能而不需要数据库支持

二、代码测试

1、添加相关依赖pom.xml

[code]<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>

<groupId>com.example.demo</groupId>
<artifactId>springboot-quartz</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>

<name>springboot-quartz</name>

<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.5.RELEASE</version>
</parent>

<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>

<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>

<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.46</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
</dependency>

<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
</dependency>

<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>2.2.1</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
</dependency>

<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<scope>provided</scope>
</dependency>
</dependencies>

<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>

</project>

2、创建配置实体类:

[code]package com.example.demo.entity;

import lombok.Data;

/**
* 路径:com.example.demo.entity
* 类名:
* 功能:《用一句描述一下》
* 备注:
* 创建人:typ
* 创建时间:2018/10/10 12:00
* 修改人:
* 修改备注:
* 修改时间:
*/
@Data
public class Config {

private Integer id;
private String cron;

}

3、创建任务类,添加注解@EnableScheduling(标注启动定时任务)

[code]package com.example.demo.service;

import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.stereotype.Component;

/**
* 路径:com.example.demo.service
* 类名:
* 功能:任务类
* 备注:
* 创建人:typ
* 创建时间:2018/10/10 12:03
* 修改人:
* 修改备注:
* 修改时间:
*/
@Slf4j
@Configuration
@Component
@EnableScheduling
public class ScheduledTask {

public void sayHello(){
log.info("Hello world, i'm the king of the world!!!");
}
}

4、Quartz配置类

[code]package com.example.demo.config;

import com.example.demo.service.ScheduledTask;
import lombok.extern.slf4j.Slf4j;
import org.quartz.Trigger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.quartz.CronTriggerFactoryBean;
import org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean;
import org.springframework.scheduling.quartz.SchedulerFactoryBean;

/**
* 路径:com.example.demo.config
* 类名:
* 功能:Quartz配置类
* 备注:
* 创建人:typ
* 创建时间:2018/10/10 12:05
* 修改人:
* 修改备注:
* 修改时间:
*/
@Slf4j
@Configuration
public class QuartzConfig {

/**
* 方法名:
* 功能:配置定时任务
* 描述:
* 创建人:typ
* 创建时间:2018/10/10 12:06
* 修改人:
* 修改描述:
* 修改时间:
*/
@Bean(name = "jobDetail")
public MethodInvokingJobDetailFactoryBean detailFactoryBean(ScheduledTask task){
MethodInvokingJobDetailFactoryBean jobDetail = new MethodInvokingJobDetailFactoryBean();
/*
* 是否并发执行
* 例如每5s执行一次任务,但是当前任务还没有执行完,就已经过了5s了,
* 如果此处为true,则下一个任务会执行,如果此处为false,则下一个任务会等待上一个任务执行完后,再开始执行
*/
jobDetail.setConcurrent(false);
//设置定时任务的名字
jobDetail.setName("srd-demo");
//设置任务的分组,这些属性都可以在数据库中,在多任务的时候使用
jobDetail.setGroup("srd");

//为需要执行的实体类对应的对象
jobDetail.setTargetObject(task);

/*
* sayHello为需要执行的方法
* 通过这几个配置,告诉JobDetailFactoryBean我们需要执行定时执行ScheduleTask类中的sayHello方法
*/
jobDetail.setTargetMethod("sayHello");
log.info("jobDetail 初始化成功!");
return jobDetail;
}

/**
* 方法名:
* 功能:配置定时任务的触发器,也就是什么时候触发执行定时任务
* 描述:
* 创建人:typ
* 创建时间:2018/10/10 12:14
* 修改人:
* 修改描述:
* 修改时间:
*/
@Bean(name = "jobTrigger")
public CronTriggerFactoryBean cronTriggerFactoryBean(MethodInvokingJobDetailFactoryBean jobDetail){
CronTriggerFactoryBean trigger = new CronTriggerFactoryBean();
trigger.setJobDetail(jobDetail.getObject());
//初始化的cron表达式(每天上午10:15触发)
trigger.setCronExpression("0 15 10 * * ?");
//trigger的name
trigger.setName("srd-demo");
log.info("jobTrigger 初始化成功!");
return trigger;
}

/**
* 方法名:
* 功能:定义quartz调度工厂
* 描述:
* 创建人:typ
* 创建时间:2018/10/10 14:06
* 修改人:
* 修改描述:
* 修改时间:
*/
@Bean(name = "scheduler")
public SchedulerFactoryBean schedulerFactoryBean(Trigger trigger){
SchedulerFactoryBean factoryBean = new SchedulerFactoryBean();
//用于quartz集群,QuartzScheduler启动时更新已存在的job
factoryBean.setOverwriteExistingJobs(true);
//延时启动,应用启动1秒后
factoryBean.setStartupDelay(1);
//注册触发器
factoryBean.setTriggers(trigger);
log.info("scheduler 初始化成功!");
return factoryBean;
}
}

MethodInvokingJobDetailFactoryBean:此工厂主要用来制作一个jobDetail,即制作一个任务。由于我们所做的定时任务根本上讲其实就是执行一个方法。所以用这个工厂比较方便。

注意:其setTargetObject所设置的是一个对象而不是一个类。

CronTriggerFactoryBean:定义一个触发器。

注意:setCronExpression:是一个表达式,如果此表达式不合规范,即会抛出异常。

SchedulerFactoryBean:主要的管理的工厂,这是最主要的一个bean。quartz通过这个工厂来进行对各触发器的管理。

5、定时查询数据库,并更新任务

[code]package com.example.demo.service;

import com.example.demo.mapper.ConfigMapper;
import lombok.extern.slf4j.Slf4j;
import org.quartz.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

import javax.annotation.Resource;

/**
* 路径:com.example.demo.config
* 类名:
* 功能:定时产查询数据库,并更新任务
* 备注:
* 创建人:typ
* 创建时间:2018/10/10 14:15
* 修改人: 
* 修改备注:
* 修改时间:
*/
@Slf4j
@Configuration
@EnableScheduling
@Component
public class ScheduleRefreshService {

@Autowired
private ConfigMapper configMapper;

@Resource(name = "jobDetail")
private JobDetail jobDetail;

@Resource(name = "jobTrigger")
private CronTrigger cronTrigger;

@Resource(name = "scheduler")
private Scheduler scheduler;

/**
* 方法名:
* 功能:每隔10s查库,并根据查询结果决定是否重新设置定时任务
* 描述:
* 创建人:typ
* 创建时间:2018/10/10 14:19
* 修改人:
* 修改描述:
* 修改时间:
*/
@Scheduled(fixedRate = 10000)
public void scheduleUpdateCronTrigger() throws SchedulerException {
CronTrigger trigger = (CronTrigger) scheduler.getTrigger(cronTrigger.getKey());
//当前Trigger使用的
String currentCron = trigger.getCronExpression();
log.info("currentCron Trigger:{}", currentCron);
//从数据库查询出来的
String searchCron = configMapper.findOne(1).getCron();
log.info("searchCron  Trigger:{}", searchCron);

if (currentCron.equals(searchCron)) {
// 如果当前使用的cron表达式和从数据库中查询出来的cron表达式一致,则不刷新任务
} else {
//表达式调度构建器
CronScheduleBuilder scheduleBuilder = CronScheduleBuilder.cronSchedule(searchCron);
//按新的cronExpression表达式重新构建trigger
trigger = (CronTrigger) scheduler.getTrigger(cronTrigger.getKey());
trigger = trigger.getTriggerBuilder().withIdentity(cronTrigger.getKey()).withSchedule(scheduleBuilder).build();
// 按新的trigger重新设置job执行
scheduler.rescheduleJob(cronTrigger.getKey(), trigger);
currentCron = searchCron;
}
}

}

6、配置数据库连接application.yml

[code]server:
port: 8081

spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/mc_config
username: root
password: admin
initial-size: 1
min-idle: 1
max-active: 20

7、相关表及测试数据

[code]create table config(
id int(10),
cron varchar(40),
primary key(id)
);

insert into config(id,cron) values(1,'0 0/2 * * * ?'); //每隔2分钟执行一次

启动测试

[code]2018-10-10 15:47:54.622  INFO 16340 --- [pool-1-thread-1] c.e.demo.service.ScheduleRefreshService  : currentCron Trigger:0 15 10 * * ?
2018-10-10 15:47:54.625  INFO 16340 --- [           main] c.e.demo.SpringbootQuartzApplication     : Started SpringbootQuartzApplication in 2.757 seconds (JVM running for 3.873)
2018-10-10 15:47:54.647  INFO 16340 --- [pool-1-thread-1] c.e.demo.service.ScheduleRefreshService  : searchCron  Trigger:0 0/2 * * * ?
2018-10-10 15:47:55.611  INFO 16340 --- [ler [scheduler]] o.s.s.quartz.SchedulerFactoryBean        : Starting Quartz Scheduler now, after delay of 1 seconds
2018-10-10 15:47:55.611  INFO 16340 --- [ler [scheduler]] org.quartz.core.QuartzScheduler          : Scheduler scheduler_$_NON_CLUSTERED started.
2018-10-10 15:48:00.014  INFO 16340 --- [eduler_Worker-1] com.example.demo.service.ScheduledTask   : Hello world, i'm the king of the world!!!
2018-10-10 15:48:04.622  INFO 16340 --- [pool-1-thread-1] c.e.demo.service.ScheduleRefreshService  : currentCron Trigger:0 0/2 * * * ?
2018-10-10 15:48:04.626  INFO 16340 --- [pool-1-thread-1] c.e.demo.service.ScheduleRefreshService  : searchCron  Trigger:0 0/2 * * * ?
2018-10-10 15:48:14.622  INFO 16340 --- [pool-1-thread-1] c.e.demo.service.ScheduleRefreshService  : currentCron Trigger:0 0/2 * * * ?
2018-10-10 15:48:14.626  INFO 16340 --- [pool-1-thread-1] c.e.demo.service.ScheduleRefreshService  : searchCron  Trigger:0 0/2 * * * ?

cronExpression表达式:     

 cronExpression表达式:

字段   允许值   允许的特殊字符
 
0-59
 
, - * /
 
0-59
 
, - * /
小时
 
0-23
 
, - * /
日期
 
1-31
 
, - *   / L W C
月份
 
1-12 或者 JAN-DEC
 
, - * /
星期
 
1-7 或者 SUN-SAT
 
, - *   / L C #
年(可选)
 
留空, 1970-2099
 
, - * /
“*”字符被用来指定所有的值。如:”*“在分钟的字段域里表示“每分钟”。 
“-”字符被用来指定一个范围。如:“10-12”在小时域意味着“10点、11点、12点”。
“,”字符被用来指定另外的值。如:“MON,WED,FRI”在星期域里表示”星期一、星期三、星期五”。
“?”字符只在日期域和星期域中使用。它被用来指定“非明确的值”。当你需要通过在这两个域中的一个来指定一些东西的时候,它是有用的。看下面的例子你就会明白。
“L”字符指定在月或者星期中的某天(最后一天)。即“Last ”的缩写。但是在星期和月中“L”表示不同的意思,如:在月子段中“L”指月份的最后一天-1月31日,2月28日,如果在星期字段中则简单的表示为“7”或者“SAT”。如果在星期字段中在某个value值得后面,则表示“某月的最后一个星期value”,如“6L”表示某月的最后一个星期五。
“W”字符只能用在月份字段中,该字段指定了离指定日期最近的那个星期日。
“#”字符只能用在星期字段,该字段指定了第几个星期value在某月中。

      每一个元素都可以显式地规定一个值(如6),一个区间(如9-12),一个列表(如9,11,13)或一个通配符(如*)。“月份中的日期”和“星期中的日期”这两个元素是互斥的,因此应该通过设置一个问号(?)来表明你不想设置的那个字段。 

cron表达式:

表达式

  意义
"0 0 12 * * ?"
 
每天中午12点触发
"0 15 10 ? * *"
 
每天上午10:15触发
"0 15 10 * * ?"
 
每天上午10:15触发
"0 15 10 * * ? *"
 
每天上午10:15触发
"0 15 10 * * ? 2005"
 
2005年的每天上午10:15
触发
"0 * 14 * * ?"
 
在每天下午2点到下午2:59期间的每1分钟触发
"0 0/5 14 * * ?"
 
在每天下午2点到下午2:55期间的每5分钟触发
"0 0/5 14,18 * * ?"
 
在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
"0 0-5 14 * * ?"
 
在每天下午2点到下午2:05期间的每1分钟触发
"0 10,44 14 ? 3 WED"
 
每年三月的星期三的下午2:10和2:44触发
"0 15 10 ? * MON-FRI"
 
周一至周五的上午10:15触发
"0 15 10 15 * ?"
 
每月15日上午10:15触发
"0 15 10 L * ?"
 
每月最后一日的上午10:15触发
"0 15 10 ? * 6L"
 
每月的最后一个星期五上午10:15触发 
"0 15 10 ? * 6L 2002-2005"
 
2002年至2005年的每月的最后一个星期五上午10:15触发
"0 15 10 ? * 6#3"
 
每月的第三个星期五上午10:15触发
每天早上6点: 0 6 * * * 
每两个小时: 0 */2 * * * 
晚上11点到早上8点之间每两个小时,早上八点 :0 23-7/2,8 * * * 
每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点 :0 11 4 * 1-3 
月1日早上4点 :0 4 1 1 *

 

阅读更多
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: 
相关文章推荐