Quartz.Net进阶之五：TriggerListener 、JobListener 和 SchedulerListener

        一、介绍

            今天开始学习监听器，就是 Listener，在Quartz.Net 中，主要包含3类的监听器，主要内容包括：TriggerListener 、JobListener 和 SchedulerListener 这三个东东的内容，这个东西不是很难，内容也不是很多，大家学习起来会很轻松。废话少说，开始我们今天的学习吧。

        二、TriggerListener 、JobListener 和 SchedulerListener

            侦听器是根据调度器中发生的事件创建来执行操作的对象。正如您可能猜到的，TriggerListeners接收与触发器相关的事件，JobListeners接收与作业相关的事件。

            1、与触发器相关的事件包括：触发器触发，触发错误触发（在本文档的“触发器”部分中讨论）和触发器完成（触发器触发的作业完成）。

            ITriggerListener 接口

            public interface ITriggerListener
            {
                 string Name { get; }
    
                 Task TriggerFired(ITrigger trigger, IJobExecutionContext context);
    
                 Task<bool> VetoJobExecution(ITrigger trigger, IJobExecutionContext context);
    
                 Task TriggerMisfired(ITrigger trigger);
    
                 Task TriggerComplete(ITrigger trigger, IJobExecutionContext context, int triggerInstructionCode);
            }

            2、与 Job 相关的事件包括：Job 即将执行的通知，以及 Job 完成执行时的通知。

            IJobListener 接口

            public interface IJobListener
            {
                string Name { get; }

                Task JobToBeExecuted(IJobExecutionContext context);

                Task JobExecutionVetoed(IJobExecutionContext context);

                Task JobWasExecuted(IJobExecutionContext context, JobExecutionException jobException);
            } 

            3、使用自己的监听器

            要创建侦听器，只需创建一个实现 ITriggerListener 或 IJobListener 接口的对象。然后在运行时向调度程序注册侦听器，并且必须给侦听器一个名称（或者更确切地说，它们必须通过Name属性来宣传自己的名称）。

            为了方便起见，您的类还可以扩展 JobListenerSupport 或 TriggerListenerSupport 类并简单地覆盖您感兴趣的事件，而不是实现那些接口。

            侦听器与Matcher一起向调度程序的ListenerManager注册，Matcher描述侦听器想要为哪些作业/触发器接收事件。

            侦听器在运行时向调度程序注册，并且不与作业和触发器一起存储在JobStore中。这是因为侦听器通常是与应用程序的集成点。因此，每次应用程序运行时，都需要用调度器重新注册侦听器。

            增加对特定作业感兴趣的 JobListener：

                scheduler.ListenerManager.AddJobListener(myJobListener, KeyMatcher<JobKey>.KeyEquals(new JobKey("myJobName", "myJobGroup")));

            增加对特定组的所有作业感兴趣的 JobListener：

                scheduler.ListenerManager.AddJobListener(myJobListener, GroupMatcher<JobKey>.GroupEquals("myJobGroup"));

            增加对两个特定组的所有作业感兴趣的 JobListener：

                scheduler.ListenerManager.AddJobListener(myJobListener,
    OrMatcher<JobKey>.Or(GroupMatcher<JobKey>.GroupEquals("myJobGroup"), GroupMatcher<JobKey>.GroupEquals("yourGroup")));

            增加对所有作业感兴趣的 JobListener：

                scheduler.ListenerManager.AddJobListener(myJobListener, GroupMatcher<JobKey>.AnyGroup());

            大多数Quartz.NET用户不使用侦听器，但是当应用程序要求创建事件通知的需要时，无需Job本身显式地通知应用程序，侦听器非常方便。

            4、SchedulerListeners

            SchedulerListener 与 ITriggerListener 和 IJobListener 非常相似，只是它们接收到调度器本身中的事件的通知——不一定与特定触发器或作业相关的事件。

            与调度程序相关的事件包括：添加作业/触发器，删除作业/触发器，调度程序中的严重错误，调度程序关闭的通知等。

            ISchedulerListener 接口

                public interface ISchedulerListener
                {
                    Task JobScheduled(Trigger trigger);

                    Task JobUnscheduled(string triggerName, string triggerGroup);

                    Task TriggerFinalized(Trigger trigger);

                    Task TriggersPaused(string triggerName, string triggerGroup);

                    Task TriggersResumed(string triggerName, string triggerGroup);

                    Task JobsPaused(string jobName, string jobGroup);

                    Task JobsResumed(string jobName, string jobGroup);

                    Task SchedulerError(string msg, SchedulerException cause);

                    Task SchedulerShutdown();
                } 

            SchedulerListener（调度器侦听器）在调度器的 ListenerManager 中注册。SchedulerListener（调度器侦听器）实际上可以是实现 ISchedulerListener 接口的任何对象。

            增加一个SchedulerListener：

                scheduler.ListenerManager.AddSchedulerListener(mySchedListener);

            删除一个SchedulerListener：
           

                scheduler.ListenerManager.RemoveSchedulerListener(mySchedListener);

        三、总结

            好了，今天就写到这里了。大家感觉应该很轻松，内容不多。还是老规矩，我把英文原文地址发出来，英文好的可以直接看英文，理解的会更好。地址如下：https://www.quartz-scheduler.net/documentation/quartz-3.x/tutorial/trigger-and-job-listeners.html

            不忘初心，继续努力。