Quartz 框架 教程（中文版）2.2.x 之第四课 更多关于Triggers

原文地址：http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/tutorial-lesson-04

 

第四课 更多关于Triggers

       跟作业任务类似，触发器也非常容易使用，但是在你能够充分掌握Quartz之前，你需要知道并理解许多触发器的客户化的参数。前面已经提到过，有许多不同类型的触发器供你选择，适用不同的调度需求。

       你将会在第五课 Simple Trigger和第六课 Triggers学到这两种常用的触发器类型。

 

触发器通用属性

         所有类型的触发器都有TriggerKey属性去跟踪触发器标识，除了这一个事实之外，还有许多其他的属性，对所有触发器类型都适用。这些通用属性在创建触发器定义时通过TriggerBuilder类来设定的。

        下面的属性列表对所有类型的触发器都通用：

        jobKey表示job实例的标识，触发器被触发时，该指定的job实例会执行。

       startTime属性表示触发器的时间表首次被触发的时间。它的值是定义由指定日历时间的java.util.Date对象。对于一些类型的触发器，会在启动时间触发，另一些触发器则仅仅是标示了调度器将要被触发的时间。这意味着你可以在调度器中存储一个触发器，例如每月的5号，如果现在是一月份，而startTime参数又设置为4月1日，那这样需要几个月后触发器才会第一次被触发。

       endTime属性指定触发器的不再被触发的时间，换言之，调度器中的触发器定义为“每月的5号”，而且endTime设置为7月1日，那么6月5日将会是最后一次触发的日期。

       其它的属性，更多更详细的讲解将会在接下来的子章节中进行讨论。

 

Priority（优先级）

       有些时候，当你有许多触发器（或Quartz线程池中只有少数几个工作线程），Quartz可能没有足够的资源去触发所有的在同一时间段内排定好的触发器。既然这样，你可能期望控制哪个触发器能第一个获得Quartz空闲工作线程的调用。为了达到这个目的，你可以设定触发器的Priority属性。如果N个触发器在同一时间内被触发，但只有Z工作线程当前空闲可用，那么拥有最高优先级的Z触发器将会第一个被触发。如果你没有设置触发器的优先级，它将会使用默认的优先级，优先级值为5.任何Integer类型的值都可以作为优先级，正数负数都可以。

       提示：优先级只是用于在同一时间被触发的触发器进行比较。一个安排在10:59分触发的触发器永远要比安排在11:00的触发器先执行。

       提示：当一个触发器的作业任务发现设置了请求恢复参数，在恢复调度执行时的优先级和原来的一样。

 

触发失败指令

       触发器另外一个重要的属性就是“misfireinstruction”。触发失败的情况是由于调度器被关闭导致存储的触发器错过了触发的时间，或是由于Quartz线程池内没有空闲的线程去执行作业任务。不同类型的触发器有不同的触发失败处理机制。默认情况下使用“智能策略”指令——基于触发器类型和配置的动态机制。当调度器启动时，它会查询所有存储的、触发失败的触发器，然后根据各自配置的触发失败指令更新触发器。当你开始在你的项目中使用Quartz时，你应该让自己熟悉在给定触发器类型上定义的触发失败指令和JavaDoc上的文档解释。更多关于触发失败指令的详细信息将会在教程里每个触发器类型课程中作详细介绍。

 

Calendars（日历）

       当触发器在调度器中创建和存储时，Quartz日历对象（区别于java.util.Calendar对象）可以与触发器相关联。日历对触发器调度定义不包含的时间段非常方便。例如，你可以创建一个触发器，定义在每个工作日上午9：30分触发作业任务，另外添加一个日历表排除当中所有的假期。

       日历对象可以是实现Calendar接口的任何可序列化的对象，如下所示：

       Calendar接口

package org.quartz;

public interface Calendar {

  public boolean isTimeIncluded(long timeStamp);

  public long getNextIncludedTime(long timeStamp);

}

 

       注意这些方法的参数是long类型。你可能已经猜到，这些是毫秒单位的时间戳格式。这意味着日历“屏蔽”的时间段可以精确到毫秒级。最有可能的是，我们喜欢“屏蔽”一整天的时间。为了方便起见，Quartz包含的类org.quartz.impl.HolidayCalendar，可以完成刚刚提及的功能。

       日历实例化和注册到调度器中必须通过addCalendar方法。如果你使用HolidayCalendar，初始化对象完成后，应该使用addExcludedDate(Datedate)方法方便将你希望从调度时间表中排除的日期添加到日历实例对象中。同一个日历实例对象可以应用于多个触发器，如下代码：

       Calendar示例

HolidayCalendar cal = new HolidayCalendar();
cal.addExcludedDate( someDate );
cal.addExcludedDate( someOtherDate );

sched.addCalendar("myHolidays", cal, false);


Trigger t = newTrigger()
    .withIdentity("myTrigger")
    .forJob("myJob")
    .withSchedule(dailyAtHourAndMinute(9, 30)) // execute job daily at 9:30
    .modifiedByCalendar("myHolidays") // but not on holidays
    .build();

// .. schedule job with trigger

Trigger t2 = newTrigger()
    .withIdentity("myTrigger2")
    .forJob("myJob2")
    .withSchedule(dailyAtHourAndMinute(11, 30)) // execute job daily at 11:30
    .modifiedByCalendar("myHolidays") // but not on holidays
    .build();

// .. schedule job with trigger2

 

       关于触发器结构/构建详细信息将会在后面两节课中介绍。现在，只需要相信上面的代码创建了两个触发器对象，每个触发器每天都会被触发。然而，任何发生在日历对象中排除的日期内的触发将会跳过。

    可以查阅org.quartz.impl.calendar包目录下的几个Calendar实现类，估计有适合你需要的类。