第二課：QuartzAPI,Jobs和Triggers簡介

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);
 

        生成Job定義呼叫的方法程式碼塊靜態地匯入了JobBuilder類，同樣地，生成觸發器呼叫的方法程式碼塊靜態地匯入了TriggerBuilder類，SimpleScheduleBuilder類也是靜態匯入的。

         DSL靜態匯入的實現可以通過以下幾個import語句完成：

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例項物件，尤其針對特定的時間點，比如下一個的整點時間，換言之現在是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時，我們決定構建排程器時拆分開排程和任務是有意義的，在我看來，這樣做還是有許多好處。

        例如，作業任務可以獨立於觸發器在作業排程中建立和儲存，多個觸發器可以關聯到相同的作業任務中。另一個好處是在作業任務關聯的觸發器失效後，仍然能夠在排程器上鬆耦合地配置作業任務，因此該作業不需要重新定義，一段時間後能夠重新排程。它還允許你在不重新例項化關聯的作業任務下修改和替換觸發器。

Identites（識別符號）

        作業任務和觸發器被註冊到Quartz排程器時需要提供標識資訊。這種標識資訊（也稱作作業任務鍵和觸發器鍵）允許作業任務和觸發器按組存放，這樣可以很方便地將你的作業任務和觸發器分組，比如分為“報表類Job”和“維護類Job”。作業任務和觸發器的鍵的名稱部分在同一個組內必須唯一，換句話說，作業任務和觸發器的鍵（或識別符號）的名字是由鍵名和組名共同組成的。

    現在你對作業任務和觸發器有一個大概的瞭解了，你可以在“第三課 更多關於Jobs和JobDetails”和“第四課 更多關於Triggers”學到更多關於它們的知識。