一、简介

1. 介绍
Quartz是OpenSymphony开源组织在Job scheduling领域又一个开源项目，是完全由java开发的一个开源的任务日程管理系统，“任务进度管理器”就是一个在预先确定（被纳入日程）的时间到达时，负责执行（或者通知）其他软件组件的系统。
Quartz用一个小Java库发布文件（.jar文件），这个库文件包含了所有Quartz核心功能。这些功能的主要接口(API)是Scheduler接口。它提供了简单的操作，例如：将任务纳入日程或者从日程中取消，开始/停止/暂停日程进度。
2. 定时器种类
Quartz 中五种类型的 Trigger：SimpleTrigger，CronTirgger，DateIntervalTrigger，NthIncludedDayTrigger和Calendar 类（ org.quartz.Calendar）。
最常用的：
SimpleTrigger：用来触发只需执行一次或者在给定时间触发并且重复N次且每次执行延迟一定时间的任务。
CronTrigger：按照日历触发，例如“每个周五”，每个月10日中午或者10：15分。
3. 存储方式
RAMJobStore和JDBCJobStore
对比：

类型

优点

缺点

RAMJobStore

不要外部数据库，配置容易，运行速度快

因为调度程序信息是存储在被分配给JVM的内存里面，所以，当应用程序停止运行时，所有调度信息将被丢失。另外因为存储到JVM内存里面，所以可以存储多少个Job和Trigger将会受到限制

JDBCJobStore

支持集群，因为所有的任务信息都会保存到数据库中，可以控制事物，还有就是如果应用服务器关闭或者重启，任务信息都不会丢失，并且可以恢复因服务器关闭或者重启而导致执行失败的任务

运行速度的快慢取决与连接数据库的快慢

4. 表关系和解释

  • 表关系

    • Quartz任务调度框架--简介与示例（一）_数据库

  • 解释

表名称

说明

qrtz_blob_triggers

Trigger作为Blob类型存储(用于Quartz用户用JDBC创建他们自己定制的Trigger类型，JobStore 并不知道如何存储实例的时候)

qrtz_calendars

以Blob类型存储Quartz的Calendar日历信息， quartz可配置一个日历来指定一个时间范围

qrtz_cron_triggers

存储Cron Trigger，包括Cron表达式和时区信息。

qrtz_fired_triggers

存储与已触发的Trigger相关的状态信息，以及相联Job的执行信息

qrtz_job_details

存储每一个已配置的Job的详细信息

qrtz_locks

存储程序的非观锁的信息(假如使用了悲观锁)

qrtz_paused_trigger_graps

存储已暂停的Trigger组的信息

qrtz_scheduler_state

存储少量的有关 Scheduler的状态信息，和别的 Scheduler 实例(假如是用于一个集群中)

qrtz_simple_triggers

存储简单的 Trigger，包括重复次数，间隔，以及已触的次数

qrtz_triggers

存储已配置的 Trigger的信息

qrzt_simprop_triggers

 

5. 核心类和关系

  1. 核心类
    （1）核心类
    QuartzSchedulerThread：负责执行向QuartzScheduler注册的触发Trigger的工作的线程。
    ThreadPool：Scheduler使用一个线程池作为任务运行的基础设施，任务通过共享线程池中的线程提供运行效率。
    QuartzSchedulerResources：包含创建QuartzScheduler实例所需的所有资源（JobStore，ThreadPool等）。
    SchedulerFactory：提供用于获取调度程序实例的客户端可用句柄的机制。
    JobStore： 通过类实现的接口，这些类要为org.quartz.core.QuartzScheduler的使用提供一个org.quartz.Job和org.quartz.Trigger存储机制。作业和触发器的存储应该以其名称和组的组合为唯一性。
    QuartzScheduler：这是Quartz的核心，它是org.quartz.Scheduler接口的间接实现，包含调度org.quartz.Jobs，注册org.quartz.JobListener实例等的方法。
    Scheduler：这是Quartz Scheduler的主要接口，代表一个独立运行容器。调度程序维护JobDetails和触发器的注册表。 一旦注册，调度程序负责执行作业，当他们的相关联的触发器触发（当他们的预定时间到达时）。
    Trigger：具有所有触发器通用属性的基本接口，描述了job执行的时间出发规则。 - 使用TriggerBuilder实例化实际触发器。
    JobDetail：传递给定作业实例的详细信息属性。 JobDetails将使用JobBuilder创建/定义。
    Job：要由表示要执行的“作业”的类实现的接口。只有一个方法 void execute(jobExecutionContext context)
    (jobExecutionContext 提供调度上下文各种信息，运行时数据保存在jobDataMap中)
    Job有个子接口StatefulJob ,代表有状态任务。
    有状态任务不可并发，前次任务没有执行完，后面任务处于阻塞等到。
  2. 关系-自己理解

Quartz任务调度框架--简介与示例（一）_调度程序_02

一个job可以被多个Trigger 绑定，但是一个Trigger只能绑定一个job！

6. 配置文件
quartz.properties
//调度标识名 集群中每一个实例都必须使用相同的名称 （区分特定的调度器实例）
org.quartz.scheduler.instanceName：DefaultQuartzScheduler
//ID设置为自动获取 每一个必须不同 （所有调度器实例中是唯一的）
org.quartz.scheduler.instanceId ：AUTO
//数据保存方式为持久化
org.quartz.jobStore.class ：org.quartz.impl.jdbcjobstore.JobStoreTX
//表的前缀
org.quartz.jobStore.tablePrefix ： QRTZ_
//设置为TRUE不会出现序列化非字符串类到 BLOB 时产生的类版本问题
//org.quartz.jobStore.useProperties ： true
//加入集群 true 为集群 false不是集群
org.quartz.jobStore.isClustered ： false
//调度实例失效的检查时间间隔
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（threadPriority 属性的最大值是常量 java.lang.Thread.MAX_PRIORITY，等于10。最小值为常量 java.lang.Thread.MIN_PRIORITY，为1）
//自创建父线程
//org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread： true
//数据库别名
org.quartz.jobStore.dataSource ： qzDS
//设置数据源
org.quartz.dataSource.qzDS.driver:com.mysql.jdbc.Driver
org.quartz.dataSource.qzDS.URL:jdbc:mysql://localhost:3306/quartz
org.quartz.dataSource.qzDS.user:root
org.quartz.dataSource.qzDS.password:123456
org.quartz.dataSource.qzDS.maxConnection:10

7.JDBC插入表顺序

主要的JDBC操作类，执行sql顺序。
Simple_trigger ：插入顺序
qrtz_job_details —> qrtz_triggers —> qrtz_simple_triggers
qrtz_fired_triggers
Cron_Trigger：插入顺序
qrtz_job_details —> qrtz_triggers —> qrtz_cron_triggers
qrtz_fired_triggers

二、示例

1、配置文件：

#\u96c6\u7fa4\u914d\u7f6e
org.quartz.scheduler.instanceName: dufy_test
org.quartz.scheduler.instanceId = AUTO

 
//线程池相关的配置
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.jobStore.misfireThreshold: 60000
 
#============================================================================
# Configure JobStore
#============================================================================
 
#\u9ed8\u8ba4\u914d\u7f6e\uff0c\u6570\u636e\u4fdd\u5b58\u5230\u5185\u5b58
#org.quartz.jobStore.class: org.quartz.simpl.RAMJobStore
#\u6301\u4e45\u5316\u914d\u7f6e
//任务信息内存存储
org.quartz.jobStore.class:org.quartz.simpl.RAMJobStore

2、示例代码：

任务执行：

public class RAMQuartz {

  private static Logger _log = LoggerFactory.getLogger(RAMQuartz.class);
  
  public static void main(String[] args) throws SchedulerException {
    //1.创建Scheduler的工厂
    SchedulerFactory sf = new StdSchedulerFactory();
    //2.从工厂中获取调度器实例
    Scheduler scheduler = sf.getScheduler();
    
    
    //3.创建JobDetail
    JobDetail jb = JobBuilder.newJob(RAMJob.class)
        .withDescription("this is a ram job") //job的描述
        .withIdentity("ramJob", "ramGroup") //job 的name和group
        .build();
    
    //任务运行的时间，SimpleSchedle类型触发器有效
    long time=  System.currentTimeMillis() + 3*1000L; //3秒后启动任务
    Date statTime = new Date(time);
    
    //4.创建Trigger
      //使用SimpleScheduleBuilder或者CronScheduleBuilder
    Trigger t = TriggerBuilder.newTrigger()
          .withDescription("")
          .withIdentity("ramTrigger", "ramTriggerGroup")
          //.withSchedule(SimpleScheduleBuilder.simpleSchedule())
          .startAt(statTime)  //默认当前时间启动
          .withSchedule(CronScheduleBuilder.cronSchedule("0/10 * * * * ?")) //两秒执行一次
          .build();
    
    //5.注册任务和定时器
    scheduler.scheduleJob(jb, t);
    
    //6.启动 调度器
    scheduler.start();
    _log.info("启动时间 ： " + new Date());
      
  }
}

任务：

继承实现Job接口

public class RAMJob implements Job{
  
  @Override
  public void execute(JobExecutionContext arg0) throws JobExecutionException {
    
    System.err.println("Say hello to Quartz " + System.currentTimeMillis());
  }
  
}

运行结果：

Quartz任务调度框架--简介与示例（一）_触发器_03