一. 引言

1.1 简介

  • Quartz: http://www.quartz-scheduler.org/
  • 是一个 定时任务调度框架 ,比如我们遇到这样的问题
    • 想在30分钟后, 查看订单是否支付, 未支付则取消订单
    • 想在每月29号, 信用卡自动还款
    • ...
    • 想定时在某个时刻, 去做某件事情(任务)
  • Quartz是要做定时任务的调度, 设置好触发时间规则, 以及相应的任务(Job)即可

二. 使用Quartz

2.1 导入依赖

<!--quartz任务调度-->

<dependency>

    <groupId>org.quartz-scheduler</groupId>

    <artifactId>quartz</artifactId>

    <version>2.3.2</version>

</dependency>

2.2 定义Job

package com.dz.job;

import org.quartz.*;

import java.util.Date;

//Job任务 要定时执行的某件事

public class HelloJob implements Job {

    @Override

    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {

        //创建工作详情

        JobDetail jobDetail = jobExecutionContext.getJobDetail();

        JobKey key = jobDetail.getKey();

        String jobName = key.getName();//任务名

        String jobGroup = key.getGroup();//任务group

        System.out.println("job执行, job: " + jobName + "group: " + jobGroup + new Date());

        System.out.println(new Date());

    }

}

2.3 API测试

package com.dz.job;

import org.quartz.*;

import org.quartz.impl.StdSchedulerFactory;

import java.util.Calendar;

import java.util.GregorianCalendar;

public class HelloQuartz {

    public static void main(String[] args) throws SchedulerException {

        try {

            //quartz API

            //1. 调度器Scheduler

            Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

            //2. 触发器

            SimpleTrigger trigger = TriggerBuilder.newTrigger()

                    .withIdentity("trigger1", "group1")//定义name/group

                    .startNow()//一旦加入scheduler, 立即生效, 即开始计时

                    .withSchedule(SimpleScheduleBuilder.simpleSchedule()

                            .withIntervalInSeconds(2)//每隔两秒执行一次

                            .repeatForever())//一直执行, 知道结束时间

                    .endAt(new GregorianCalendar(2021, Calendar.MAY, 19, 23, 59, 56).getTime())//设置结束时间

                    .build();

            //3. JobDetail

            //定义Job类为HelloJob类, 这是真正的执行逻辑所在

            JobDetail jobDetail = JobBuilder.newJob(HelloJob.class)

                    .withIdentity("job1", "group1")//定义name/group

                    .build();

            //4. 将 任务和触发器 增加到调度器中

            scheduler.scheduleJob(jobDetail,trigger);

            //5. 启动, 调度器开始工作

            scheduler.start();

        } catch (SchedulerException e) {

            e.printStackTrace();

        }

    }

}

2.4 配置

  • 名称为: quartz.properties, 放在classpath下, 如果没有此配置则按默认配置启动
#指定调度器的名称, 非实现类

org.quartz.scheduler.instanceName = DefaultQuartzScheduler

#指定线程池实现类

org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool

#线程池线程数量

org.quartz.threadPool.threadCount = 10

#优先级, 默认5

org.quartz.threadPool.threadPriority = 5

#非持久化job

org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

2.5 核心类说明

  • Scheduler: 调度器, 所有的调度器都是由它控制, 是Quartz的大脑, 所有任务都是由它来管理
  • Job: 任务, 想定时执行的事情(定义业务逻辑)
  • JobDetail: 基于Job, 进一步包装, 其中关联一个Job, 并为Job指定更详细的属性, 比如标识等
  • Trigger: 触发器. 可以指定给某个任务, 指定任务的触发机制

三. Trigger

3.1 SimpleTrigger

  • 以一定的时间间隔(单位是毫秒) 执行的任务

    • 指定起始和截止时间(时间段)
    • 指定时间间隔, 执行次数
  • 示例:
SimpleTrigger trigger = TriggerBuilder.newTrigger()

                    .withIdentity("trigger1", "group1")

                    .startNow()

                    .withSchedule(SimpleScheduleBuilder.simpleSchedule()

                            .withIntervalInSeconds(1)//每秒执行一次

                            .repeatForever())//一直执行, 直到结束时间

                    .endAt(new GregorianCalendar(2021, Calendar.MAY, 19, 23, 59, 56).getTime())

                    .build();

					


SimpleTrigger trigger = TriggerBuilder.newTrigger()

                    .withIdentity("trigger1", "group1")

                    .startNow()

                    .withSchedule(SimpleScheduleBuilder.simpleSchedule()

                            .withIntervalInMinutes(3)//每三分钟执行一次

                            .withRepeatCount(3))//执行次数不超过3次

                    .endAt(new GregorianCalendar(2021, Calendar.MAY, 19, 23, 59, 56).getTime())

                    .build();

3.2 CronTrigger [重点]

  • 适合于更复杂的任务, 它支持类型于Linux Cron的语法(并且更强大)

    • 指定Cron表达式即可
  • 示例:
//3月25当天, 每两秒执行一次

CronTrigger trigger = TriggerBuilder.newTrigger()

                    .withIdentity("trigger1", "group1")//定义name/group

                    .withSchedule(CronScheduleBuilder.cronSchedule("*/2 * * 25 3 ?"))

                    .build();




//每天的10-12点, 每隔2分钟执行一次

CronTrigger trigger = TriggerBuilder.newTrigger()

                    .withIdentity("trigger1", "group1")//定义name/group

                    .withSchedule(CronScheduleBuilder.cronSchedule("0 */2 10-12 * * ?"))

                    .build();
3.2.1 Cron表达式组成
  • 表达式组成: "秒 分 时 日 月 星期几 [年]", 其中"年"是可选的, 一般不指定

    • 如: "10 20 18 3 5 ?"代表5月3日18点20分10秒, 星期几不确定
位置	  时间域			  允许值		特殊值

1		秒钟			    0-59		,-*/

2 		分钟			    0-59		,-*/

3 		小时				0-23		,-*/

4 		日期				1-31		,-*?/LW

5 		月份				1-12		,-*/

6 		星期				1-7(1为周日) ,-*?/L#

7 		年份(可不写)					  ,-*/
3.2.2 Cron表达式符号
  • 表达式中可使用的特殊符号的含义如下
星号(*): 可用在所有字段中, 表示对应时间域的每一个时刻, 例如,在分钟字段内表示"每分钟"

问号(?): 该字段只在日期和星期字段中使用, 它通常指定为"不确定值"

减号(-): 表达一个范围, 如在小时字段中使用"10-12", 则表示从10点到12点

逗号(,): 表达一个列表值, 如在星期字段中使用"MON,WED,FRI", 则表示星期一,星期三,星期五

斜杠: x/y表达一个等步长序列, x为起始值, y为增量步长值. 如在分钟字段中使用0/15,则表示为0,15,30和45秒, 而5/15在分钟字段中表示5,20,35,50

井号(#): 该字符只用在星期字段中, "4#2"代表第2个星期三, "5#4"代表第4个星期四

L: 该字符只有在日期和星期字段中使用, 代表"Last"的意思, 但它在两个字段中的含义不同,如果L用在星期字段里, 则表示星期六,等同于7, L出现在星期字段里,而且前面有一个数值x,则表示"这个月的最后一个周x", 例如: 6L表示该月的最后星期五, L在日期字段中, 表示这个月份的最后一天, 如一月的31号, 非闰年二月的28号

W: 该字符只能出现在日期字段中, 是对前导日期的修饰, 表示离该日期最近的工作日, 例如15W表示该月15号最近的工作日, 如果该月15号是星期六, 则匹配14号的星期五; 如果15号是星期日, 则匹配16号的星期一, 如果15号是星期二, 那么结果就是15号星期二; 但要注意关联的匹配日期不能跨月

LW: 在日期字段可以组合使用LW, 它的意思是当月的最后一个工作日
3.2.3 Cron表达式示例
  • 演示示例
0 0 12 * * ?: 每天12点运行

0 15 10 * * ?: 每天10:15运行

0 15 10 * * 2020: 在2020年的每天10:15运行

0 * 14 * * ?: 每天14点到15点之间每分钟运行一次, 开始于14:00,结束于14:59

0 0/5 14 * * ?: 每天14点到15点之间每5分钟运行一次, 开始于14:00,结束于14:55

0 0/5 14,18 * * ?: 每天14点到15点之间每5分钟运行一次, 此外每天18点到19点之间也是每5分钟运行一次

0 0-5 14 * * ?: 每天14:00到14:05, 每分钟运行一次

0 0-5/2 14 * * ?: 每天14:00到14:05, 每2分钟运行一次

0 10,44 14 ? 3 4: 3月每周三的14:10和14:44, 每分钟运行一次

0 15 10 ? * 2-6: 每周一,二,三四,五的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 2019-2021: 在2019,2020,2021年每个月的最后一个星期五的10:15运行

四. Spring整合Quartz [重点]

4.1 导入依赖

<dependencies>

    <!--quartz任务调度-->

    <dependency>

        <groupId>org.quartz-scheduler</groupId>

        <artifactId>quartz</artifactId>

        <version>2.3.2</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-context-support</artifactId>

        <version>5.3.6</version>

    </dependency>

    <dependency>

        <groupId>org.springframework</groupId>

        <artifactId>spring-tx</artifactId>

        <version>5.3.6</version>

    </dependency>

</dependencies>

4.2 定义Job

  • 定义一个Job类
package com.dz.job;

import org.quartz.Job;

import org.quartz.JobExecutionContext;

import org.quartz.JobExecutionException;

import java.util.Date;

public class MyJob implements Job {

    @Override

    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {

        System.out.println("job执行" + new Date());

    }

}

4.3 配置

  • applicationContext.xml中

    • 调度器 ScheduleFactoryBean
    • 触发器 CronTriggerFactoryBean
    • JobDetail JobDetailFactoryBean
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!--

        Spring整合Quartz进行配置遵循下面的步骤:

        1. 定义工作任务的Job

        2. 定义触发器Trigger, 并将触发器与工作任务绑定

        3. 定义调度器, 并将Trigger注册到Scheduler

    -->

    <!--1. 定义任务的bean, 这里使用JobDetailFactoryBean, 也可以使用MethodInvokingJobDetailFactoryBean, 配置类似-->

    <bean name="lxJob" class="org.springframework.scheduling.quartz.JobDetailFactoryBean">

        <!--指定Job的名称-->

        <property name="name" value="job1"/>

        <!--指定Job的分组-->

        <property name="group" value="job_group1"/>

        <!--指定具体的Job类-->

        <property name="jobClass" value="com.dz.job.MyJob"/>

    </bean>

    <!--2. 定义触发器的bean, 定义一个Cron的Trigger, 一个触发器只能和一个任务进行绑定-->

    <bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">

        <!--指定Trigger的名称-->

        <property name="name" value="trigger1"/>

        <!--指定Trigger的分组-->

        <property name="group" value="trigger_group1"/>

        <!--指定Trigger绑定的JobDetail-->

        <property name="jobDetail" ref="lxJob"/>

        <!--指定Cron的表达式, 当前是每隔5秒运行一次-->

        <property name="cronExpression" value="*/5 * * * * ?"/>

    </bean>

    <!--3. 定义调度器, 并将Trigger注册到调度器中-->

    <bean id="scheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">

        <property name="triggers">

            <list>

                <ref bean="cronTrigger"/>

            </list>

        </property>

        <!--添加quartz配置, 如下两种方式均可-->

        <!--<property name="configLocation" value="classpath:quartz.properties"/>-->

        <property name="quartzProperties">

            <value>

                #指定调度器的名称, 实际类型为: QuartzScheduler

                org.quartz.scheduler.instanceName = MyScheduler

                #指定线程池实现类

                org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool

                #线程池线程数量

                org.quartz.threadPool.threadCount = 10

                #优先级, 默认5

                org.quartz.threadPool.threadPriority = 5

                #不持久化job

                org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

            </value>

        </property>

    </bean>

</beans>

折叠

4.4 操作

4.4.1 启动任务
  • 工厂启动, 调度器启动, 任务调度开始
public class QuartzTest {

    public static void main(String[] args) throws InterruptedException, SchedulerException {

        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");

    }

}
4.4.2 任务操作
4.4.2.1 删除任务
package com.dz;

import org.quartz.JobKey;

import org.quartz.SchedulerException;

import org.quartz.impl.StdScheduler;

import org.springframework.context.support.ClassPathXmlApplicationContext;

public class QuartzTest {

    public static void main(String[] args) throws InterruptedException, SchedulerException {

        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");

        StdScheduler stdScheduler = (StdScheduler) context.getBean("scheduler");

        Thread.sleep(5000);

        //删除Job

        stdScheduler.deleteJob(JobKey.jobKey("job1","job_group1"));

    }

}
4.4.2.2 暂停, 恢复
package com.dz;

import org.quartz.JobKey;

import org.quartz.SchedulerException;

import org.quartz.impl.StdScheduler;

import org.springframework.context.support.ClassPathXmlApplicationContext;

public class QuartzTest {

    public static void main(String[] args) throws InterruptedException, SchedulerException {

        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");

        StdScheduler stdScheduler = (StdScheduler) context.getBean("scheduler");

        Thread.sleep(5000);

        //暂停Job

        stdScheduler.pauseJob(JobKey.jobKey("job1", "job_group1"));

        Thread.sleep(5000);

        //恢复Job

        stdScheduler.resumeJob(JobKey.jobKey("job1","job_group1"));

    }

}
4.4.2.3 批量操作
package com.dz;

import org.quartz.JobKey;

import org.quartz.SchedulerException;

import org.quartz.impl.StdScheduler;

import org.quartz.impl.matchers.GroupMatcher;

import org.springframework.context.support.ClassPathXmlApplicationContext;

public class QuartzTest {

    public static void main(String[] args) throws InterruptedException, SchedulerException {

        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");

        StdScheduler stdScheduler = (StdScheduler) context.getBean("scheduler");

        Thread.sleep(5000);

        GroupMatcher<JobKey> group1 = GroupMatcher.groupEquals("job_group1");

        //暂停组中所有工作

        stdScheduler.pauseJobs(group1);

        Thread.sleep(5000);

        //恢复组中所有工作

        stdScheduler.resumeJobs(group1);

    }

}

8_Quartz的更多相关文章

随机推荐

  1. NewApiDay03_File类

    File类创建一个新文件 File类的每一个实例可以表示硬盘(文件系统)中的一个文件或目录(实际上表示的是一个抽象路径) 使用File可以做到: 1:访问其表示的文件或目录的属性信息,例如:名字,大小 ...

  2. Solution -「ABC 217」题解

    D - Cutting Woods 记录每一个切割点,每次求前驱后驱就好了,注意简单判断一下开闭区间. 考场上采用的 FHQ_Treap 无脑莽. #include <cstdio> #i ...

  3. ESXI启用本地登录和SSH服务连接功能，使用Xshell连接

    1.选中Troubleshoot Options进行SSH服务配置 2.开启本地登录功能 3.开启远程连接功能 4.本地登录修改SSH服务允许基于密码登录 默认无法用密码登录ssh服务,只支持基于ke ...

  4. Webpack学习系列 - Webpack5 怎么集成Babel ？

    程序员优雅哥简介:十年程序员,呆过央企外企私企,做过前端后端架构.分享vue.Java等前后端技术和架构. 本文摘要:主要通过实操讲解运用Webpack 5 如何集成 Babel Babel 对于前端 ...

  5. python获取线程返回值

    python获取线程返回值 前言 工作中的需求 将前端传过来的字符串信息通过算法转换成语音,并将语音文件返回回去 由于算法不是我写的,只需要调用即可,但是算法执行速度相当缓慢 我的优化思路是,将前端的 ...

  6. 【Java面试】这道互联网高频面试题难住了80%的程序员？索引什么时候失效？

    "索引什么时候失效?" 面试过程中,突如其来的一个问题,是不是有点懵? 没关系,关注我,面试不迷路. 我是Mic,一个工作了14年的Java程序员. 索引失效涉及到的知识点非常多, ...

  7. webSocket的基本使用与socket.io库使用

    前言: 传统的客户端与服务器进行通信,都是客户端向服务端发送请求,服务端进行响应,否则一般不会自动进行响应.单向,如果要持续获取服务端资源,则需要持续发送请求 初解决方案:轮询:客户端让http请求保 ...

  8. MyBatis 02 配置

    导入jar包 <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</a ...

  9. 通过route , tracert , traceroute 查看本地路由配置及访问ip或域名时经过的路由信息

    转载请注明出处: 1.路由器和交换机的区别和过程 在windows 系统或linux 系统访问 外网ip 或域名时,都会通过层层的路由器,然后将请求转发到最终的目标服务器:因为互联网通过路由器实现公网 ...

  10. rcu的学习记录

    crash> p rcu_sched_state.node[0] $13 = { lock = { raw_lock = { slock = 748760225 } }, gpnum = 211 ...