Quartz API
Quartz API 主要包含了以下接口
- Scheduler – 调度器，任务调度的主 API。
- Job – 由调度器调度的任务需要实现的接口。
- JobDetail – 用于定义任务的实例。
- Trigger – 用于定义需要执行的任务和任务的执行时间。
- JobBuilder – 用于定义/创建 JobDetail 实例。
- TriggerBuilder – 用于定义/创建 Trigger 对象。
Scheduler（调度器）的生命周期由 SchedulerFactory 创建 Scheduler 开始到调用 shutdown() 结束。
一旦创建了 Scheduler 实例，就可以新增，移除，查看 Job 和 Trigger，和执行其它调度相关工作（例如暂停 Trigger）。
如果 Scheduler 没有调用 start() 方法，那么将不会执行任何 Trigger 上的任务。
Quartz 定义了 builder 类，它们定义了 Domain Specific Language（DSL，有时也成为“流式接口”）。
如下所示
// define the job and tie it to our HelloJob class JobDetail job = newJob(MyJob.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);
上面代码中:
创建 job 使用到的方法来自静态导入的 JobBuilder 类，
创建 Trigger 的方法来自静态导入的 TriggerBuilder，
同样也静态导入了 SimpleScheduleBuilder。
静态导入的 DSL 可以通过下面语法定义：
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 有多个变体，用于定义不同类型的周期。
DateBuilder 中包含了大量的方法方便创建 java.util.Date 实例来指定时间。
Jobs 和 Triggers
任务需要实现 Job 接口，接口中只有一个方法：
package org.quartz; public interface Job { public void execute(JobExecutionContext context) throws JobExecutionException; }
当任务的 Trigger 被触发，任务的 execute 方法将会由调度器的一个工作线程调用。传入这个方法的 JobExecutionContext 对象用于提供任务运行环境的信息（包含了一个 Scheduler 的句柄，一个Trigger 的句柄，一个 JobDetail 的句柄和几个其它项）。
JobDetail 由 Quartz 客户端创建（你自己编写）。它包含了大量的任务属性设置和 JobMetaMap 对象（可用于存储任务的状态信息）。这个类本质上来说是用于定义 Job 对象。
Trigger 对象用于触发任务的执行。它定义了任务的执行时间。当你创建了一个 Trigger，你需要提供你需要的时间表（schedule）用于控制任务的执行。Trigger 可能还包含了 JobDataMap 对象，当你需要传递参数给 Job 的时候，这个类就相当有用。Quartz 提供了几个 Trigger 的实现，其中最常用的是 SimpleTrigger 和 CronTrigger。
SimpleTrigger 用于执行某个时间点执行一次的任务，或用于在某个时间执行一次任务，并且在 T 周期重复执行 N 次。CronTrigger 用于基于日历的任务，例如“每周五中午”或“每个月10号上午10点15分”执行。
为什么需要 Job 和 Trigger？有些任务调度方案没有分离 job 和 trigger，为什么 Quartz 需要分别定义 Job 和 Trigger 呢？主要基于以下考虑。
多个 Job 可以保存到同一个 Trigger，多个 Trigger 也可以关联到相同的 Job。这种松耦合的设计的另外一个好处是可以在 trigger 过期后配置任务到调度器中，方便以后重新开始任务，而不用再次定义任务。也允许在不更换任务的情况下更改和替换 Trigger。
唯一标识
Jobs 和 Triggers 可以使用 Quartz 调度器注册一个唯一标识。Job 和 Trigger 的键（JobKey 和 TriggerKey）允许进行分组，这对于任务和触发器来说非常易于组织成像“报表任务”或“维护任务”这样的分组。 分组中的键必须唯一。
