[译]Quartz 2.2.x 第七课：触发监听器和作业任务监听器

监听器是在调度器中基于事件机制执行操作的对象。你大概可以猜到，触发监听器接收响应跟触发器有关的事件，作业任务监听器接收响应跟作业任务有关的事件。

        跟触发器有关的事件包括：触发器被触发，触发器触发失败（在触发器课程中讨论过），以及触发器触发完成（触发器完成后作业任务开始运行）。

org.quartz.TriggerListener的接口

public interface TriggerListener {

    public String getName();

    public void triggerFired(Trigger trigger, JobExecutionContext context);

    public boolean vetoJobExecution(Trigger trigger, JobExecutionContext context);

    public void triggerMisfired(Trigger trigger);

    public void triggerComplete(Trigger trigger, JobExecutionContext context,
            int triggerInstructionCode);
}



  
  

   
   跟作业任务相关的事件包括：job即将被执行的通知和job执行完成的通知事件。
  
  

  
  

   
   


  
  

  
  

   
   org.quartz.JobListener接口
  
  

  
  

   
   
   
   
public interface JobListener {

    public String getName();

    public void jobToBeExecuted(JobExecutionContext context);

    public void jobExecutionVetoed(JobExecutionContext context);

    public void jobWasExecuted(JobExecutionContext context,
            JobExecutionException jobException);

}
   
   


   
   

    
    使用自己开发的监听器
   
   

   
   

    
    


   
   

   
   

    
    要创建一个监听器，可以简单地创建一个实现org.quartz.TriggerListener或org.quartz.JobListener接口的对象即可。监听器会在运行期间注册到调度器中，并且必须要给定监听器名（或者更确切地说，监听器会调用getName方法获取自己的名字）。
   
   

   
   


   
   


   
   

    
    


   
   

   
   

    
           为了方便使用，监听器除了实现这些接口，你还可以继承ITriggerListener 和IJobListener 类，可以只重写你感兴趣的事件方法。
   
   

   
   

    
    


   
   

   
   

    
           监听器注册到调度器中的监听器管理类时还携带着一个匹配器，这个匹配器描述了作业任务和触发器的监听器想接收的事件。
   
   

   
   

    
    


   
   

   
   

    
           监听器在运行期间注册到调度中，但是不会把作业任务和触发器存储到JobStore中。那是因为监听器在你的应用中通常是一些点的集合。因此，每次应用运行时，监听器都需要重新在调度器中注册。
   
   

   
   

    
    


   
   

   
   

    
    在一个指定的作业任务中添加Job监听器：
   
   

   
   


   
   


   
   
scheduler.getListenerManager().addJobListener(myJobListener, KeyMatcher.jobKeyEquals(new JobKey("myJobName", "myJobGroup")));

   
   

    
    你可以使用静态引入的一些匹配器或关键类，来定义你的作业任务。
   
   

   
   

    
    
    
    
import static org.quartz.JobKey.*;
import static org.quartz.impl.matchers.KeyMatcher.*;
import static org.quartz.impl.matchers.GroupMatcher.*;
import static org.quartz.impl.matchers.AndMatcher.*;
import static org.quartz.impl.matchers.OrMatcher.*;
import static org.quartz.impl.matchers.EverythingMatcher.*;
...etc.
   
   

   
   

    
    

    
    

     
     在你感兴趣的一个作业组中所有的作业任务添加上Job监听器：
    
    

    
    

     
     
scheduler.getListenerManager().addJobListener(myJobListener, jobGroupEquals("myJobGroup"));
    
    

    
    

     
     


    
    

    
    

     
      
在你感兴趣的两个作业组中所有的作业任务添加上Job监听器：
    
    

    
    

     
     
     
     
scheduler.getListenerManager().addJobListener(myJobListener, or(jobGroupEquals("myJobGroup"), jobGroupEquals("yourGroup")));
    
    

    
    

     
     


    
    

    
    

     
       
在所有作业中添加Job监听器：
    
    

    
    

     
     
scheduler.getListenerManager().addJobListener(myJobListener, allJobs());
     
     


    
    

    
    

     
             注册Trigger监听器也用同样的方法。
    
    

    
    

     
     


    
    

    
    

     
        
大部分的Quartz用户都不会用到监听器，但是当应用要求创建需要的事件通知时，而没有Job实例去通知应用时，使用监听器非常方便。