【7】TriggerListeners and JobListeners

旧城等待， 2022-07-16 03:49 107阅读 0赞

参考链接:[http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/tutorial-lesson-07.html][http_www.quartz-scheduler.org_documentation_quartz-2.2.x_tutorials_tutorial-lesson-07.html]  
`Listeners`， 监听器，当某些事件发生的时候，立马去执行Listener里定义的操作。`TriggerListeners` 是针对triggers的，`JobListener` 从jobs那接收事件。

和trigger相关的事件包括：trigger触发的时候，出现trigger mis-firings 的时候，job执行完后(也就是trigger的触发结束以后)。

#### The org.quartz.TriggerListener Interface ####

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将要执行的时候，job执行完成后。

#### The org.quartz.JobListener Interface ####

public interface JobListener {
    
        public String getName();
    
        public void jobToBeExecuted(JobExecutionContext context);
    
        public void jobExecutionVetoed(JobExecutionContext context);
    
        public void jobWasExecuted(JobExecutionContext context,
                JobExecutionException jobException);
    
    }

### Using Your Own Listeners ###

要创建一个Listener, 只需要创建一个实现了`org.quartz.TriggerListener` 或`org.quartz.JobListener` 接口的对象即可。  
在运行的时候，将Listeners注册进scheduler, 而且必须给一个name(可以通过他们的getName()方法获取Listener的name)。

除了继承接口，类也可以继承`JobListenerSupport` 或`TriggerListenerSupport` ，重写你感兴趣的event。

Listener通过scheduler的ListenerManager来注册，其中的`Matcher` 里描述哪个Jobs、Triggers需要被监听。

> Listeners在运行的时候被注册进scheduler, 而不是保存在JobStore。Listener是和你的应用集成在一起的，这样每次你的应用运行的时候，都会在scheduler中重新注册listeners。

#### Adding a JobListener that is interested in a particular 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.

上面的代码就可以变成：

scheduler.getListenerManager().addJobListener(myJobListener, jobKeyEquals(jobKey("myJobName", "myJobGroup")));

#### Adding a JobListener that is interested in all jobs of a particular group: ####

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

#### Adding a JobListener that is interested in all jobs of two particular groups: ####

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

#### Adding a JobListener that is interested in all jobs: ####

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

注册TriggerListeners和上面的代码是一样的。

有了Listeners以后，当应用需要在某些事件发生以后去通知你的应用，这时就不需要Job去明确地去告知你的应用了。

[http_www.quartz-scheduler.org_documentation_quartz-2.2.x_tutorials_tutorial-lesson-07.html]: http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/tutorial-lesson-07.html