Quartz学习资料(完全).pdf

Quartz 学习资料（完全）

介绍 Quartz

Quartz 是一个开源的任务调度系统，它能用来调度很多任务的执行。

运行环境

Quartz 能嵌入在其他应用程序里运行。

Quartz 能在一个应用服务器里被实例化 (或 servlet 容器 ), 并且参与 XA 事务

Quartz 能独立运行（通过 JVM） ,或者通过 RMI

Quartz 能被集群实例化

任务调度

在一个指定的次数重复

重复到一个指定的时间 /日期

无限重复

在一个间隔内重复

能够给任务指定名称和组名 .触发器也能够指定名称和组名 ,这样可以很好的在调度器里组织

起来 .一个加入到调度器里的任务可以被多个触发器注册。 在 J2EE 环境里， 任务能作为一个

分布式（ XA）事务的一部分来执行。

任务执行

任务能够是任何实现 Job 接口的 Java 类。

任务类能够被 Quartz 实例化 ,或者被你的应用框架。

Quartz 的设计包含 JobStore 接口，这个接口能被实现来为任务的存储提供不同的机

制。

应用 JDBCJobStore, 所有被配置成“稳定”的任务和触发器能通过 JDBC 存储在关

系数据库里。

应用 RAMJobStore, 所有任务和触发器能被存储在 RAM 里因此不必在程序重起之

间保存 -一个好处就是不必使用数据库。

事务

使用 JobStoreCMT （ JDBCJobStore 的子类），Quartz 能参与 JTA 事务。

Quartz 能管理 JTA 事务 (开始和提交 )在执行任务之间，这样，任务做的事就可以发

生在 JTA 事务里。

插件机制可以给 Quartz 增加功能，例如保持任务执行的历史记录，或从一个定义好

的文件里加载任务和触发器。

Quartz 装配了很多插件和监听器。

1.使用 Quartz

在我们用调度器之前，调度器需要实例化。我们用 SchedulerFactory 来实例它。一旦调度器

被实例，我们就可以启动它，置它为 stand-by 模式，最后关闭它。注意：一旦一个调度器被

关闭了， 如果我们不重新实例化它， 它就不可能被再次启动。 直到调度器启动了或者当调度

器处于暂停状态，触发器才能够触发。下面有个简单的例子：

SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory();

Scheduler sched = schedFact.getScheduler();

trigger.setName("myTrigger");

sched.scheduleJob(jobDetail, trigger);

就象你看到的，使用 Quartz 是很简单的。在下一节我们介绍 Jobs 和 Triggers 。

2.Jobs 和 Triggers

就象以前提到的，一个实现了 Job 接口的 Java类就能够被调度器执行。接口如下：

package org.quartz;

public interface Job {

public void execute(JobExecutionContext context) throws JobExecutionException;

}

很简的，当 Job 的 trigger 触发时， Job 的 execute(..)方法就会被调度器调用。被传递到

器触发的 job 传参数的。Quartz 有一些不同的触发器类型， 不过，用得最多的是 SimpleTrigger

和 CronTrigger 。

如果我们需要在给定时刻执行一次 job 或者在给定时刻触发 job 随后间断一定时间不停

的执行的话， SimpleTrigger 是个简单的解决办法；如果我们想基于类似日历调度的触发 job

的话，比如说， 在每个星期五的中午或者在每个月第 10 天的 10：15 触发 job 时，CronTrigger

是很有用的。

为什么用 jobs 和 triggers 呢？很多任务调度器并没有任务和触发器的概念， 一些任务调度器

简单定义一个“ job”为在一个执行时间伴随一些小任务标示，其他的更像 Quartz 里 job 和

trigger 对象的联合体。在开发 Quartz 时，开发者们决定，在调度时间表和在这上面运行的

工作应该分开。这是很有用的。

例如， job 能够独立于触发器被创建和储存在任务调度器里，并且，很多的触发器能够

加上组名。如果把组名置为 ”null”，系统会自动给它置为 Scheduler.DEFAULT_GROUP

现在，我们大概有了一些 jobs 和 triggers 的理解，随后 2 节我们将根多的了解它们。

3.更多关于 Jobs & JobDetails

Jobs 很容易实现， 这儿有更多我们需要理解的东西： jobs 的本质， job 接口的 execute(..)方法，

当我们实现的一个 class 是真正的 ”job”时， Quartz 需要知道各种 job 有的属性，这是通

过 JobDetail 类做到的。在没用 JobDetail 之前， JobDetail 的功能的实现是通过在每个 job 的

实现类上加上所有的现在 JobDetail 的 get 方法来实现的。 这就在每个 job 类上强加了一些实

现一样功能的代码，就显得每个 job 类很笨重，于是， Quartz 开发者们就创造了 JobDetail

类。

现在， 我们来讨论一下在 Quartz 里 job 的本质和 job 实例的生命周期。 首先我们来看看

第一节的代码片段：

JobDetail jobDetail = new JobDetail("myJob", // job 名称

sched.DEFAULT_GROUP, // job 组名 (可以写 'null' 来用 default group)

DumbJob.class); //要执行的 java 类

public DumbJob() {

}

public void execute(JobExecutionContext context)

throws JobExecutionException

{

System.err.println("DumbJob is executing.");

}

}

可以看到我们给调度器一个 JobDetail 实例，并且，它通过 job 的类代码引用这个 job 来执行。

每次调度器执行 job 时，它会在调用 job 的 execute(..)方法之前创建一个他的实例。 这就带来

JobDataMap 实现了 Java Map 接口，它有一些附加的方法，这些方法用来储存和跟踪简单类

型的数据。

如下代码可以很快地给 job 增加 JobDataMap：

jobDetail.getJobDataMap().put("jobSays", "Hello World!");

jobDetail.getJobDataMap().put("myFloatValue", 3.141f);

在 job 执行时，我们可以在 job 里通过如下代码得到 JobDataMap：

public class DumbJob implements Job {

}

public void execute(JobExecutionContext context)

throws JobExecutionException

{

String instName = context.getJobDetail().getName();

String instGroup = context.getJobDetail().getGroup();

JobDataMap dataMap = context.getJobDetail().getJobDataMap();

String jobSays = dataMap.getString("jobSays");

进一步信息可以在 Java Developer Connection Tech Tip: Serialization In The Real World 里找

到。我们能把 JDBC-JobStore 和 JobDataMap 放到一个模式里， 在那里，只有简单类型和 String

型能被储存在 Map 里，从而消去任何以后的序列化问题。

Stateful vs. Non-Stateful Jobs

触发器也有与它们关联的 JobDataMaps。假设我们有一个储存在调度器里被多个触发器关联

的 job，然而，对于每个独立的触发器，我想提供给 job 不同的数据输入，在这个时候，

JobDataMaps 就很有用了。

在 job执行期间，JobDataMaps 能够在 JobExecutionContext 里获得。JobDataMap 融合在 Trigger

和 JobDetail 类里， JobDataMap 里面的值能够利用 key 来更新。

public class DumbJob implements Job {

public DumbJob() {

public void execute(JobExecutionContext context)

throws JobExecutionException

{