Quartz-基础组件

最新推荐文章于 2024-02-18 23:10:14 发布
最新推荐文章于 2024-02-18 23:10:14 发布
阅读量223 收藏 1
点赞数
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Impler/article/details/84867889
版权

Quartz 主要API

  • Scheduler 任务调度器，按照特定的触发规则，自动执行任务
  • Job 接口，定义需要执行的任务
  • JobDetail 包含job的基本信息
  • Trigger 描述Job执行的时间触发规则
  • JobStore 存放Job、Trigger等信息

Scheduler

Scheduler是一个任务调度器，保存JobDetail和Trigger的信息。 在Trigger触发时，执行特定任务。

2523457-33eb20c753a75723.png
Schedualer体系

实现了org.quartz.Scheduler接口的StdSchedule实际只是QuartzScheduler的静态代理，后者实现了Scheduler所有操作。

创建

Scheduler由SchedulerFactory创建。
SchedulerFactory有两个默认实现StdSchedulerFactory和DirectSchedulerFactory。

2523457-ac39424d720b4ffa.png
Schedualer Factory继承体系

Scheduler的创建过程包括：

    1. 读取配置文件, 配置文件中需要配置scheduler、线程池、jobStore、jobListener、triggerListenner、插件等。配置文件的读取过程如下：
    • 读取参数系统参数System中配置的org.quartz.properties指定的文件
    • 如果找不到则读取项目Classpath目录下的quartz.properties配置文件
    • 如果找不到则读取quartz jar包中默认的配置文件quartz.properties
    1. 从SchedulerRepository中根据名称读取已经创建的scheduler，
    1. 如果没有则重新创建一个，并保存在SchedulerRepository中。

存储

Scheduler存储在单例的SchedulerRepository中。

2523457-a8b82a9d861a5eef.png
Schedualer Repository类图

生命周期

Scheduler的生命周期开始于其被创建时，结束于shutdown()方法调用。一旦对象创建完成，就可以用来操作Jobs和Triggers，包括添加、删除、查询等。但只有在Scheduler start()被调用后，才会按照Trigger定义的触发规则执行Job的内容。

2523457-5c71bdf4af29113d.png
Schedualer 生命周期

核心方法

Scheduler的核心功能就是操作Job、Trigger、Calendar、Listener等。包括addXXX、deleteXXX、pauseXXX、resumeXXX等。

2523457-35630d3c9196270b.png
Schedualer 核心方法

Job

Job接口简介

Job就是定时任务实实在在执行的内容，足够单纯，仅仅包含一个执行方法。

2523457-18e5955c9b12b7fc.png
Job

JobExecutionContext对象包含了当前任务执行的上下文环境，包括JobDetail、Trigger以及jobDataMap等。

2523457-0321e51c3968a887.png
Job运行时环境

Job的执行并不是孤立封闭的，需用与外界交互。JobDataMap是一种扩展的Map<String，Object>结构，就是用来在任务调度器与任务执行之间传递数据。如果Job中包含了与JobDataMap中key值相对应的setter方法，那么Scheduler容器将会在当前Job创建后自动调用该setter方法，完成数据传递，而不用hardcode的从map中取值。
Scheduler控制在每次Trigger触发时创建Job实例。因此JobExecutionContext.JobDataMap只是外部Scheduler容器中JobDataMap的一个拷贝，即便修改Job中的JobDataMap也只是在当前Job执行的环境中生效，并不会对外部产生任何影响。

Job的派生

Job下面又派生出两个子接口：InterruptableJob和StatefulJob

2523457-597110e0db39c008.png
Job体系结构

InterruptableJob：可被阻断的Job，InterruptableJob收到Scheduler.interrupt请求，停止任务
StatefulJob：有状态Job，标识性接口，没有操作方法。StatefulJob与普通的Job（无状态Job）从根本上有两点不同：
1. JobDataMap是共享的，即在Job中对JobDataMap的操作，将会被保存下来，其他Job拿到的将是被修改过的JobDataMap。
2. 基于第一条原因，StatefulJob是不允许并发执行的。
StatefulJob已被DisallowConcurrentExecution/PersistJobDataAfterExecution注解取代

Job的创建

Job的创建由专门的工厂来完成

2523457-c1bc5074c8c137ec.png
Job Factory结构

Job是在Quartz内部创建，受Scheduler控制，因此不需要外部参与。

JobDetail

JobDetail用于保存Job相关的属性信息

2523457-4114d0496434d5ed.png
JobDetail结构
  • JobKey唯一确定了一个Job
  • JobDataMap用于存储Job执行时必要的业务信息
  • JobDetail保存的仅仅是Job接口的Class对象，而非具体的实例。
    JobBuilder负责JobDetail实例的创建，并且JobBuilder提供了链式操作，可以方便的为JobDetail添加额外的信息。
JobDetail job = JobBuilder.newJob(HelloJob.class)
                    .withIdentity(jobKey)
                    .build();

Trigger

Trigger描述了Job的触发规则。

2523457-9e43baaa000eb41e.png
Trigger
  • TriggerKey(group,name)唯一标识了Scheduler中的Trigger
  • JobKey指向了该Trigger作用的Job
  • 一个Trigger仅能对应一个Job，而一个Job可以对应多个Trigger
  • 同样的，Trigger也拥有一个JobDataMap
  • Priority：当多个trigger拥有相同的触发时间，根据该属性来确定先后顺序，数值越大越靠前，默认5，可为正负数
  • Misfire Instructions：没来得及执行的机制。同一时间trigger数量过多超过可获得的线程资源，导致部分trigger无法执行。不同类型的Trigger拥有不同的机制。当Scheduler启动时候，首先找到没来得及执行的trigger，再根据不同类型trigger各自的处理策略处理
  • Calendar：Quartz Calendar类型而不是java.util.Calendar类型。用于排除Trigger日程表中的特定时间范围，比如原本每天执行的任务，排除非工作日

Trigger的几种状态

  • STATE_WAITING（默认）: 等待触发
  • STATE_ACQUIRED：
  • STATE_COMPLETE：
  • STATE_PAUSED：
  • STATE_BLOCKED：
  • STATE_PAUSED_BLOCKED：
  • STATE_ERROR：

Trigger的分类

2523457-e810769896cf7fc2.png
Trigger的分类

常见的两种Trigger为SimpleTrigger和CronTrigger.

SimpleTrigger

SimpleTrigger支持在特定时间点一次性执行或延迟执行N次，使用TriggerBuilder和SimpleScheduleBuilder创建
SimpleTrigger包含的属性为：

  • startTime 开始时间
  • endTime 如果指定的话，将会覆盖repeat count
  • repeat count 重复次数 >=0 int
  • repeat interval 时间间隔(毫秒) >=0 long

CronTrigger

CronTrigger支持多次重复性复杂情况，支持Cron表达式，使用TriggerBuilder和CronScheduleBuilder创建。
Cron表达式由7部分组成，分别是秒 分 时 日期 月份 星期 年（可选），空格间隔。

字段允许值允许的特殊字符
秒0-59, - * /
分0-59, - * /
小时0-23, - * /
日期1-31, - * ? / L W C
月份1-12,JAN-DEC, - * /
星期1-7,SUN-SAT, - * ? / L C #
年（可选）留空,1970-2099, - * /

特殊字符含义

  • "*": 代表所有可能的值
  • "/": 用来指定数值的增量, 在子表达式（分钟）里的0/15表示从第0分钟开始，每15分钟;在子表达式（分钟）里的"3/20"表示从第3分钟开始，每20分钟（它和"3，23，43"）的含义一样
  • "?": 仅被用于天和星期两个子表达式，表示不指定值。当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为"?"
  • "L": 仅被用于天和星期两个子表达式，它是单词"last"的缩写。如果在“L”前有具体的内容，它就具有其他的含义了。例如："6L"表示这个月的倒数第６天，"FRI L"表示这个月的最后一个星期五
  • 'W' 可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W"，意为: "离该月15号最近的工作日"。因此如果15号为周六，触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于“日”字段的值为单独的一天而不是一系列值的时候
  • 'L'和'W'可以组合用于“日”字段表示为'LW'，意为"该月最后一个工作日"。
  • '#' 字符可用于“周几”字段。该字符表示“该月第几个周×”，比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”，该月是不会触发的。
  • 'C' 字符可用于“日”和“周几”字段，它是"calendar"的缩写。 它表示为基于相关的日历所计算出的值（如果有的话）。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后"，“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。
    表达式举例
  • "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触发

定时器正则表达式验证
秒：^(\\*|[0-5]?[0-9]([,|\\-|\\/][0-5]?[0-9])*)$
分：^(\\*|[0-5]?[0-9]([,|\\-|\\/][0-5]?[0-9])*)$
时：^(\\*|([0-1]?[0-9]?|2[0-3])([,|\\-|\\/]([0-1]?[0-9]|2[0-3]))*)$
日期：^(\\*|\\?|(([1-9]|[1-2][0-9]|3[0-1])([,|\-|\/]([1-9]|[1-2][0-9]|3[0-1]))*)[CLW]?|[CLW]|LW)$
月份：^((\\*|[1-9]|(1[0-2]))([,|\-|\/]([1-9]|(1[0-2])))*)$
星期：^(\\*|L|\\?|[1-7](([,|\-|\/|\#][1-7])*|[LC]))$
年：^(\\*?|2[0-9]{3}([,|\-|\/]2[0-9]{3})*)$

Job Store

Job Store用于保存jobs, triggers等对应数据。JobStore的配置应在Quartz的配置文件中配置，代码中应该避免直接操作JobStore实例
JobStroe的实现包括：

  • RAMJobStore：把所有数据保存在内容中，速度快但不能持久化。配置org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
  • JobStoreSupport：通过jdbc，以数据库作为存储媒介
    • JobStoreCMT: 使用应用服务器提供事务管理机制
    • JobStoreTX: 不依赖与外部容器，可以自己提交、回滚事务
2523457-598f8ce5a687dd4f.png
JobStore

RAMJobStore

2523457-67aca439063ed19e.png
RAMJobStore
JobDetail的存储载体
2523457-b2134b97664a27b0.png
JobWrapper 
// 以JobDetail的group为key，存储JobKey<->JobWrapper形式的Map结构的Map
HashMap<String, HashMap<JobKey, JobWrapper>> jobsByGroup
// 以JobKey为Key，存储JobWrapper的Map
HashMap<JobKey, JobWrapper> jobsByKey
2523457-7b972133ddcef5ae.png
JobWrapper
Trigger的存储载体
2523457-004287d112d99024.png
TriggerWrapper 
// 存储所有的TriggerWrapper
ArrayList<TriggerWrapper> triggers
// 以Trigger的group为key，存储TriggerKey<->TriggerWrapper形式的Map结构的Map
HashMap<String, HashMap<TriggerKey, TriggerWrapper>> triggersByGroup
// 以TriggerKey为Key，存储TriggerWrapper
HashMap<TriggerKey, TriggerWrapper> triggersByKey
// 即将被触发的Trigger
TreeSet<TriggerWrapper> timeTriggers
2523457-7aacf228c3547b7c.png
TriggerWrapper
Impler
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Quartz组件实现定时任务
10-17
Quartz是一个开源的任务调度框架,该下载文件中附有说明文档和demo例子，希望对各位朋友们有帮助。
quartz-wm:XQuartz的quartz-wm窗口管理器
05-25
它利用了Quartz Compositor，这是Mac OS X中的一个核心图形组件，负责窗口渲染和合成。通过这种方式，quartz-wm使得X11应用能够更好地融入到Mac的外观和感觉中，提供了更一致的用户体验。 然而，随着时间的发展，...
Quartz定时任务组件
weixin_46949892的博客
05-22 156
Quartz定时任务组件
Quartz组件学习 - 20181128
weixin_30855099的博客
12-01 84
Quartz组件学习 一.引言 Quartz（中文：石英）是一个开源的任务调度框架。可以让你的程序在指定时间执行，也可以按照某一个频度执行。 支持数据库、监听器、插件、集群等特性。是一个专业的调度任务框架。 定时消息推送、定时抢购、定时发送邮件、定时统计等 java领域当中有三种技术选型，实现调度任务： ①jdk中util包下的Timer类（单线程）...
Quartz组件介绍
天涯明月
04-19 881
Quartz是一个由java编写的开源的Job调度框架，下面对其进行一个比较详细的介绍 核心组件API介绍 调度流程分析 调度示例 核心组件API介绍SchedulerFactory /Scheduler / QuartzScheduler / SchedulerFactory是用来获取调度者scheduler的一个工厂类（scheduler并没有提供构造方法），API如下 Colle...
Quartz定时组件实现定时删除图片
codingxc的博客
11-12 617
Quartz介绍 Quartz是Job scheduling（作业调度）领域的一个开源项目，Quartz既可以单独使用也可以跟spring框架整合使用，在实际开发中一般会使用后者。使用Quartz可以开发一个或者多个定时任务，每个定时任务可以单独指定执行的时间，例如每隔1小时执行一次、每个月第一天上午10点执行一次、每个月最后一天下午5点执行一次等。 官网：http://www.quartz-sc...
quartz-1.8.3.jar
04-22
在 "quartz-1.8.3.jar" 版本中，可能包含了以下组件和类： - **org.quartz.core** 包：包含 Quartz 的核心类，如 Scheduler、JobStore 和 Trigger。 - **org.quartz.impl** 包：实现 Quartz 的具体类，如 ...
springboot-quartz-elasticsearch
03-01
在本项目中，Spring Boot作为基础框架，提供了一个运行环境，使得开发者可以便捷地搭建应用，并且易于管理和部署。 **Quartz** Quartz是一个开源的作业调度框架，用于在Java应用程序中安排和执行任务。它可以设置...
quartz-1.6.6 教程，代码
05-17
- **Scheduler**：Scheduler 负责管理和执行 Jobs 和 Triggers，是 Quartz 的核心组件。 2. **Quartz 配置** - **quartz.properties**：这是 Quartz 的配置文件，用于设定调度器的行为，如数据库连接、线程池大小...
spring-quartz-021
04-28
首先，让我们深入了解Spring和Quartz的基础知识。Spring框架提供了一个全面的编程和配置模型，用于构建Java企业应用。它简化了开发过程，通过依赖注入和面向切面编程提供了松耦合和模块化的解决方案。Quartz则是一个...
quartz定时器组件（基础使用）
lc1062657810的博客
06-23 209
需要的依赖：quartz quartz-jobs quartz-jobs 以及spring整合的依赖spring-context-support <!--spring整合quartz依赖--> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</ar
Quartz定时组件
skyxuyan的专栏
05-17 395
Quartz是OpenSymphony开源组织在Job scheduling领域又一个开源项目，它可以与J2EE与J2SE应用程序相结合也可以单独使用。 package xuyan.com; import java.util.ArrayList; import java.util.Date; import java.util.List; import org.apache.commo
定时任务组件Quartz
qq_45228323的博客
12-16 2884
1.1 Quartz介绍 Quartz是OpenSymphony开源组织在Job scheduling领域的一个开源项目，由Java开发，可以用来执行定时任务，类似于java.util.Timer。Quartz是功能强大的开源作业调度库，几乎可以集成到任何Java应用程序中。Quartz包含许多企业级功能，例如对JTA事务和集群的支持。Quartz作为定时任务组件，既可以单独使用，也可以整合Spring使用。 官网：http://www.quartz-scheduler.org/ maven坐标： <
深入解析Quartz调度框架核心组件
Amber9999_的博客
08-11 110
为了更好地理解Quartz的工作原理和架构，我们需要了解其核心组件，这些组件协同工作，确保调度任务的准确执行。它是整个调度框架的中枢，负责协调各个组件的工作，确保调度任务的执行和管理。调度框架的内部工作机制。这个核心类负责执行QuartzScheduler注册的触发器（Trigger）的任务，是调度框架的执行引擎。JobStore通过接口的实现提供了作业和触发器的存储机制，为QuartzScheduler的使用提供支持。JobDetail传递作业实例的详细信息属性，它是要执行的作业的配置。
定时任务组件-quartz
qq_40955456的博客
04-01 490
一、依赖 <!--定时任务--> <dependency> <groupId>org.quartz-scheduler</groupId> <artifactId>quartz</artifactId> <version>2.2.1</version> </dependency> 二、创建定时任务 在代码执行中，如果报错并需要触发定时任务，则用以下代码新建一个定时任务 pu
Quartz组件学习记录
as噜噜噜的博客
06-03 1088
使用Quartz版本为2.2.3 主要是结合Quartz官方给出的example学习Quartz的使用，理解其中的功能。同时结合网上的资料研究一下，方便日后平台使用。 具体Quartz是干什么的，google和度娘上一箩筐。 Quartz简单的使用都可以直接看example 这里主要记录下Quartz的功能= = 可能会用到的 Maven     org.quartz-sche
Spring-Quartz内部组件架构+简易demo
Dave的博客
02-19 317
Quartz对任务调度领域进行了高度抽象，抽象出了调度器，触发器，任务。 简单介绍下几个组件的意思，具体起什么作用 Job：是一个接口，只有一个excute()，定义需要执行的任务，运行时的信息保存在JobDataMap中。 Trigger：描述触发job执行时间的触发规则。主要有SimpleTrigger和CronTrigger。 JobDetail：保存了Job的名称，描述，关联监听器等信息...
Quartz---基础
最新发布
weixin_53333436的博客
02-18 1020
创建一个类实现org.quartz.Job接口，并实现execute方法。这个方法将在作业被调度时执行。// 这里是定时任务的逻辑部分创建一个触发器来定义作业的执行计划。触发器可以指定作业的开始时间、结束时间、执行间隔等。1.配置调度器（Scheduler）：创建一个调度器实例，并使用它来安排作业和触发器。// 创建作业详情JobDetail jobDetail = JobBuilder.newJob(MyJob.class)//作业的类名。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值