资料地址:https://www.w3cschool.cn/quartz_doc/
手机上查看文档:https://m.w3cschool.cn/quartz_doc/
手册简介:
Quartz是OpenSymphony开源组织在Job scheduling领域又一个开源项目。
手册说明:
你了解 Quartz 吗?
Quartz 是一个完全由 Java 编写的开源作业调度框架,为在 Java 应用程序中进行作业调度提供了简单却强大的机制。
Quartz 可以与 J2EE 与 J2SE 应用程序相结合也可以单独使用。
Quartz 允许程序开发人员根据时间的间隔来调度作业。
Quartz 实现了作业和触发器的多对多的关系,还能把多个作业与不同的触发器关联。
Quartz 核心概念
我们需要明白 Quartz 的几个核心概念,这样理解起 Quartz 的原理就会变得简单了。
- Job 表示一个工作,要执行的具体内容。此接口中只有一个方法,如下:
void execute(JobExecutionContext context)
- JobDetail 表示一个具体的可执行的调度程序,Job 是这个可执行程调度程序所要执行的内容,另外 JobDetail 还包含了这个任务调度的方案和策略。
- Trigger 代表一个调度参数的配置,什么时候去调。
- Scheduler 代表一个调度容器,一个调度容器中可以注册多个 JobDetail 和 Trigger。当 Trigger 与 JobDetail 组合,就可以被 Scheduler 容器调度了。
Quartz的运行环境
- Quartz 可以运行嵌入在另一个独立式应用程序。
- Quartz 可以在应用程序服务器(或 servlet 容器)内被实例化,并且参与 XA 事务。
- Quartz 可以作为一个独立的程序运行(其自己的 Java 虚拟机内),可以通过 RMI 使用。
- Quartz 可以被实例化,作为独立的项目集群(负载平衡和故障转移功能),用于作业的执行。
相关教程
官方文档链接
http://www.quartz-scheduler.org/documentation/quartz-2.2.x/quick-start.html
应用案例:
Quartz 定时任务相关介绍表
莫非的老公关注
2019.03.21 11:47:59字数 285阅读 1,103
1. qrtz_job_details:存储每一个已配置的 jobDetail 的详细信息
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
job_name | 集群中job的名字,该名字用户自己可以随意定制,无强行要求 |
job_group | 集群中job的所属组的名字,该名字用户自己随意定制,无强行要求 |
description | 相关介绍 |
job_class_name | 集群中个notejob实现类的完全包名,quartz就是根据这个路径到classpath找到该job类 |
is_durable | 是否持久化,把该属性设置为1,quartz会把job持久化到数据库中 |
is_nonconcurrent | 是否并发 |
is_update_data | 是否更新数据 |
requests_recovery | 是否接受恢复执行,默认为false,设置了RequestsRecovery为true,则该job会被重新执行 |
job_data | 一个blob字段,存放持久化job对象 |
2. qrtz_triggers: 保存触发器的基本信息
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
trigger_name | 触发器的名字,该名字用户自己可以随意定制,无强行要求 |
trigger_group | 触发器所属组的名字,该名字用户自己随意定制,无强行要求 |
job_name | qrtz_job_details表job_name的外键 |
job_group | qrtz_job_details表job_group的外键 |
description | 相关介绍 |
next_fire_time | 上一次触发时间(毫秒) |
prev_fire_time | 下一次触发时间,默认为-1,意味不会自动触发 |
priority | 优先级 |
trigger_state | 当前触发器状态,设置为ACQUIRED,如果设置为WAITING,则job不会触发 ( WAITING:等待 PAUSED:暂停ACQUIRED:正常执行 BLOCKED:阻塞 ERROR:错误) |
trigger_type | 触发器的类型,使用cron表达式 |
start_time | 开始时间 |
end_time | 结束时间 |
calendar_name | 日程表名称,表qrtz_calendars的calendar_name字段外键 |
misfire_instr | 措施或者是补偿执行的策略 |
job_data | 一个blob字段,存放持久化job对象 |
3. qrtz_cron_triggers:存储触发器的cron表达式表。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
trigger_name | qrtz_triggers表trigger_name的外键 |
trigger_group | qrtz_triggers表trigger_group的外键 |
cron_expression | cron表达式 |
time_zone_id | 时区 |
4. qrtz_scheduler_state:存储集群中note实例信息,quartz会定时读取该表的信息判断集群中每个实例的当前状态。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
instance_name | 之前配置文件中org.quartz.scheduler.instanceId配置的名字,就会写入该字段 |
last_checkin_time | 上次检查时间 |
checkin_interval | 检查间隔时间 |
5. qrtz_blob_triggers:Trigger 作为 Blob 类型存储(用于 Quartz 用户用 JDBC 创建他们自己定制的 Trigger 类型,JobStore 并不知道如何存储实例的时候)
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
trigger_name | qrtz_triggers表trigger_name的外键 |
trigger_group | qrtz_triggers表trigger_group的外键 |
blob_data | 一个blob字段,存放持久化Trigger对象 |
6. qrtz_calendars:以 Blob 类型存储存放日历信息, quartz可配置一个日历来指定一个时间范围。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
calendar_name | 日历名称 |
calendar | 一个blob字段,存放持久化calendar对象 |
7. qrtz_fired_triggers:存储与已触发的 Trigger 相关的状态信息,以及相联 Job 的执行信息。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
entry_id | 调度器实例id |
trigger_name | qrtz_triggers表trigger_name的外键 |
trigger_group | qrtz_triggers表trigger_group的外键 |
instance_name | 调度器实例名 |
fired_time | 触发的时间 |
sched_time | 定时器制定的时间 |
priority | 优先级 |
state | 状态 |
job_name | 集群中job的名字,该名字用户自己可以随意定制,无强行要求 |
job_group | 集群中job的所属组的名字,该名字用户自己随意定制,无强行要求 |
is_nonconcurrent | 是否并发 |
requests_recovery | 是否接受恢复执行,默认为false,设置了RequestsRecovery为true,则会被重新执行 |
8. qrtz_locks:存储程序的悲观锁的信息(假如使用了悲观锁)。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
lock_name | 悲观锁名称 |
9. qrtz_paused_trigger_grps:存储已暂停的 Trigger 组的信息。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
trigger_group | qrtz_triggers表trigger_group的外键 |
10. qrtz_paused_trigger_grps:存储已暂停的 Trigger 组的信息。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
trigger_group | qrtz_triggers表trigger_group的外键 |
11. qrtz_simple_triggers:存储简单的 Trigger,包括重复次数,间隔,以及已触发的次数。
表字段 | 含义 |
---|---|
sched_name | 调度名称 |
trigger_name | qrtz_triggers表trigger_ name的外键 |
trigger_group | qrtz_triggers表trigger_group的外键 |
repeat_count | 重复的次数统计 |
repeat_interval | 重复的间隔时间 |
times_triggered | 已经触发的次数 |
12. qrtz_simprop_triggers:存储CalendarIntervalTrigger和DailyTimeIntervalTrigger
表字段 | 含义 |
---|---|
SCHED_NAME | 调度名称 |
TRIGGER_NAME | qrtz_triggers表trigger_ name的外键 |
TRIGGER_GROUP | qrtz_triggers表trigger_group的外键 |
STR_PROP_1 | String类型的trigger的第一个参数 |
STR_PROP_2 | String类型的trigger的第二个参数 |
STR_PROP_3 | String类型的trigger的第三个参数 |
INT_PROP_1 | int类型的trigger的第一个参数 |
INT_PROP_2 | int类型的trigger的第二个参数 |
LONG_PROP_1 | long类型的trigger的第一个参数 |
LONG_PROP_2 | long类型的trigger的第二个参数 |
DEC_PROP_1 | decimal类型的trigger的第一个参数 |
DEC_PROP_2 | decimal类型的trigger的第二个参数 |
BOOL_PROP_1 | Boolean类型的trigger的第一个参数 |
BOOL_PROP_2 | Boolean类型的trigger的第二个参数 |
0人点赞
Quartz将Job保存在数据库中所需表的说明
QRTZ_CALENDARS 以 Blob 类型存储 Quartz 的 Calendar 信息
QRTZ_CRON_TRIGGERS 存储 Cron Trigger,包括 Cron表达式和时区信息
QRTZ_FIRED_TRIGGERS 存储与已触发的 Trigger 相关的状态信息,以及相联 Job的执行信息 QRTZ_PAUSED_TRIGGER_GRPS 存储已暂停的 Trigger 组的信息
QRTZ_SCHEDULER_STATE 存储少量的有关 Scheduler 的状态信息,和别的 Scheduler实例(假如是用于一个集群中)
QRTZ_LOCKS 存储程序的悲观锁的信息(假如使用了悲观锁)
QRTZ_JOB_DETAILS 存储每一个已配置的 Job 的详细信息
QRTZ_JOB_LISTENERS 存储有关已配置的 JobListener 的信息
QRTZ_SIMPLE_TRIGGERS 存储简单的Trigger,包括重复次数,间隔,以及已触的次数
QRTZ_BLOG_TRIGGERS Trigger 作为 Blob 类型存储(用于 Quartz 用户用 JDBC创建他们自己定制的 Trigger 类型,JobStore 并不知道如何存储实例的时候)
QRTZ_TRIGGER_LISTENERS 存储已配置的 TriggerListener 的信息
QRTZ_TRIGGERS 存储已配置的 Trigger 的信息
quartz 持久化数据库表格字段解释
建表,SQL语句在quartz-1.6.6\docs\dbTables文件夹中可以找到,介绍下主要的几张表:
表qrtz_job_details: 保存job详细信息,该表需要用户根据实际情况初始化
job_name:集群中job的名字,该名字用户自己可以随意定制,无强行要求
job_group:集群中job的所属组的名字,该名字用户自己随意定制,无强行要求
job_class_name:集群中个note job实现类的完全包名,quartz就是根据这个路径到classpath找到该job类
is_durable:是否持久化,把该属性设置为1,quartz会把job持久化到数据库中
job_data:一个blob字段,存放持久化job对象
表qrtz_triggers: 保存trigger信息
trigger_name: trigger的名字,该名字用户自己可以随意定制,无强行要求
trigger_group:trigger所属组的名字,该名字用户自己随意定制,无强行要求
job_name: qrtz_job_details表job_name的外键
job_group: qrtz_job_details表job_group的外键
trigger_state:当前trigger状态,设置为ACQUIRED,如果设置为WAITING,则job不会触发
trigger_cron:触发器类型,使用cron表达式
表qrtz_cron_triggers:存储cron表达式表
trigger_name: qrtz_triggers表trigger_name的外键
trigger_group: qrtz_triggers表trigger_group的外键
cron_expression:cron表达式
表qrtz_scheduler_state:存储集群中note实例信息,quartz会定时读取该表的信息判断集群中每个实例的当前状态
instance_name:之前配置文件中org.quartz.scheduler.instanceId配置的名字,就会写入该字段,如果设置为AUTO,quartz会根据物理机名和当前时间产生一个名字
last_checkin_time:上次检查时间
checkin_interval:检查间隔时间
配置quartz.properties文件:
-
#调度标识名 集群中每一个实例都必须使用相同的名称 org.quartz.scheduler.instanceName = scheduler
-
#ID设置为自动获取 每一个必须不同 org.quartz.scheduler.instanceId = AUTO
-
#数据保存方式为持久化 org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX
-
#数据库平台 org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.oracle.weblogic.WebLogicOracleDelegate #数据库别名 随便取org.quartz.jobStore.dataSource = myXADS
-
#表的前缀 org.quartz.jobStore.tablePrefix = QRTZ_
-
#设置为TRUE不会出现序列化非字符串类到 BLOB 时产生的类版本问题 org.quartz.jobStore.useProperties = true
-
#加入集群 org.quartz.jobStore.isClustered = true
-
#调度实例失效的检查时间间隔 org.quartz.jobStore.clusterCheckinInterval = 20000
-
#容许的最大作业延长时间 org.quartz.jobStore.misfireThreshold = 60000
-
#ThreadPool 实现的类名 org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
-
#线程数量 org.quartz.threadPool.threadCount = 10
-
#线程优先级 org.quartz.threadPool.threadPriority = 5
-
#自创建父线程 org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread = true
-
#设置数据源org.quartz.dataSource.myXADS.jndiURL = CT
-
#jbdi类名 org.quartz.dataSource.myXADS.java.naming.factory.initial = weblogic.jndi.WLInitialContextFactory #URLorg.quartz.dataSource.myXADS.java.naming.provider.url = t3://localhost:7001
注】:在J2EE工程中如果想用数据库管理Quartz的相关信息,就一定要配置数据源,这是Quartz的要求。