一. 引言

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. ooday07 Java_接口

    笔记: 接口: 是一种引用数据类型 由interface定义 只能包含常量和抽象方法------默认权限是public 接口不能被实例化 接口是需要被实现/继承,实现/派生类:必须重写所有抽象方法 一 ...

  2. docker容器数据管理

    Docker容器数据卷 Docker中的数据可以存储在类似于虚拟机磁盘的介质中,在Docker中称为数据卷(Data Volume). 数据卷可以用来存储Docker应用的数据,也可以用来在Docke ...

  3. 用VS Code搞Qt6：编译源代码与基本配置

    先说明一下,本水文老周仅讨论新版的 Qt 6,旧版的 Qt 不讨论. 尽管 Qt 有自己的开发环境,但老周必须说句不装逼的话:真的不好用.说起写代码,当然了,用记事本也能写.但是,有个高逼格的工具,写 ...

  4. .NET中MongoDB之CRUD

    参考文档 https://docs.mongoing.com/mongodb-crud-operations https://docs.mongodb.com/manual/crud/ https:/ ...

  5. js中数组去重的方法

    在实际工作或面试中,我们经常会遇到"数组去重"问题,接下来就是使用js实现的数组去重的多种方法: 1.借助ES6提供的Set结构 var arr = [1,1,2,2,3,3,4, ...

  6. mysql 8.0.28 查询语句执行顺序实测结果

    TL;NRs 根据实测结果,MySQL8.0.28 中 SQL 语句的执行顺序为: (8) SELECT (5) DISTINCT <select_list> (1) FROM <l ...

  7. 4步教你学会使用Linux-Audit工具

    摘要:简单来讲audit是Linux上的审计工具,可以用来记录和监控对文件.目录.系统资源的更改:Audit无法直接增强系统的安全性,但是它可以用于发现违反系统安全政策的行为. 本文分享自华为云社区& ...

  8. 【ARK UI】HarmonyOS ETS 资源管理基本使用

    ​代码实现 api讲解 getStringArray getStringArray(resId: number, callback: AsyncCallback<Array>): void ...

  9. ss 显示unix 域 的socket 缓冲区不正确

    一个unix 域socket,平时我们用ss -auxp 来查看是否有数据在内核没有到用户态, [root@localhost unix]# ss -auxp |grep -i server.o u_ ...

  10. 论文翻译：2021_A New Real-Time Noise Suppression Algorithm for Far-Field Speech Communication Based on Recurrent Neural Network

    论文地址:一种新的基于循环神经网络的远场语音通信实时噪声抑制算法 引用格式:Chen B, Zhou Y, Ma Y, et al. A New Real-Time Noise Suppression ...