Quartz API
Quartz API关键的几个接口:
- Scheduler:跟任务调度相关的最主要的API接口。
- Job:你希望任务调度执行的组件定义(你自己的业务逻辑),都必须实现该接口。
- JobDetail:用来定义Job实例。
- Trigger:定义一个指定的Job何时被执行的组件,也叫作触发器。
- JobBuilder:用来定义或创建JobDetail的实例,JobDetail限定了只能是Job的实例。
- TriggerBuilder:用来定义或创建触发器的实例。
调度器的生命周期,起始于SchedulerFactory的创建,终止于调用shutdown方法。当调度器接口实例创建完成后,就可以添加,删除和查询Jobs和Triggers对象,也可以执行其他的跟调度器相关的操作,比如中止触发器的触发。并且,和第一课的例子中所看见的,调度器在调用start方法之前,不会触发任何一个触发器去执行作业任务。
Quartz提供了很多构建器来定义了一套领域特定语言,简称DSL,有时候也称为"流接口"。在上一课中我们看到了例子,现在重新展示一部分代码如下:
// define the job and tie it to our HelloJob class
JobDetail job = newJob(HelloJob.class)
.withIdentity("myJob", "group1") // name "myJob", group "group1"
.build();
// Trigger the job to run now, and then every 40 seconds
Trigger trigger = newTrigger()
.withIdentity("myTrigger", "group1")
.startNow()
.withSchedule(simpleSchedule()
.withIntervalInSeconds(40)
.repeatForever())
.build();
// Tell quartz to schedule the job using our trigger
sched.scheduleJob(job, trigger);
代码中,静态化地使用JobBuilder来构建了一个JobDetail,用TriggerBuilder来构建了一个Trigger。
在Quartz框架中,还有很多地方可以使用静态化引入。如:
import static org.quartz.JobBuilder.*;
import static org.quartz.SimpleScheduleBuilder.*;
import static org.quartz.CronScheduleBuilder.*;
import static org.quartz.CalendarIntervalScheduleBuilder.*;
import static org.quartz.TriggerBuilder.*;
import static org.quartz.DateBuilder.*;
不同的ScheduleBuilder类可以提供不同类型的调度器。
DataBuilder类包含了许多可以方法可以更便捷地构建Date实例对象,尤其针对特定的时间点。比如下一个的整点时间(如果现在是9:43:27,那么下一个整点就是10:00:00)。
Jobs和Triggers
作业任务类必须实现Job接口,接口只有一个方法
package org.quartz;
public interface Job {
public void execute(JobExecutionContext context)
throws JobExecutionException;
}
当作业任务的触发器被触发的那一刻,调度器的一个工作线程,会将调用该Job的execute方法。JobExecutionContext对象会向execute方法传递运行时环境的工作任务信息:执行该方法的调度器引用,触发该方法执行的触发器引用,Job实例的JobDetail对象,以及一些其他信息。
当调度器添加Job实例时,会在Quartz客户端程序中(业务代码)创建JobDetail对象。JobDetail为Job实例提供了许多设置属性,以及JobDataMap成员变量属性,它用来存储特定Job实例的状态信息。这是从本质上定义Job实例,我们将会在下一节中深入讨论相关细节。
触发器对象用来触发Job对象的执行,但跟你希望调度一项作业任务,你可以实例化一个触发器并且将触发时间属性调整为你希望的时间表。触发器也可以关联JobDataMap对象,可以非常方便地将具体的被触发的触发器当做参数传递给Job实例。
Quartz框架带少数不同类型的触发器,但最常用的类型是SimpleTrigger和CronTrigger。
SimpleTrigger适用于一次性的任务执行(在给定的时间只执行一次的作业任务),或者你需要在指定时间多次触发作业任务,每次触发都延迟固定的时间。CronTrigger适用于基于类似日历时间表的触发,比如“每个周五的下午”或“每月10号的10:15”.
为什么要分别定义作业任务和触发器?许多作业调度并没有区分作业任务和触发器的概念。有些框架把作业任务简单定义成执行时间(或计划)以及一些小作业标识符,其他框架更像是整合了Quartz框架的作业和触发器对象。因此我们设计Quartz时,我们决定构建调度器时拆分调度和任务是有意义的,在我看来,这样做还是有许多好处。
例如,作业任务可以独立于触发器在作业调度中创建和存储,多个触发器可以关联到相同的作业任务中。另一个好处是作业任务关联的触发器失效后,仍然能够在调度器上松耦合配置作业任务,因此该作业不需要重新定义,一段时间后能够重新调度。它允许你在不重新实例化关联的作业任务下修改和替换触发器。
Identiites(标识符)
作业任务和触发器被注册到Quartz调度器时需要提供标识信息。这种标识信息(也称作作业任务键和触发器键)允许作业任务和触发器按组存放,这样可以很方便地将你的作业任务和触发器分组,比如分为"报表类Job"和“维护类Job”。作业任务和触发器的键的名称部分在同一个组内必须唯一,换句话说,作业任务和触发器的键(或标识符)的名字是由键名和组名共同组成的。
现在你对作业任务和触发器有一个大概的了解了,你可以在“第三课 更多关于Jobs和JobDetails“和“第四课 更多关于Triggers”学到更多关于他们的知识。