Quartz.NET 调度器监听器(ISchedulerListener)深度解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00216/article/details/148465553

Quartz.NET 调度器监听器(ISchedulerListener)深度解析

quartznet Quartz Enterprise Scheduler .NET 项目地址: https://gitcode.com/gh_mirrors/qu/quartznet

什么是调度器监听器

在 Quartz.NET 任务调度框架中，调度器监听器(ISchedulerListener)是一种强大的扩展机制，它允许开发者监听调度器本身发生的各种事件。与触发器监听器(ITriggerListener)和作业监听器(IJobListener)不同，调度器监听器关注的是调度器级别的全局事件，而非特定触发器或作业的事件。

为什么需要调度器监听器

调度器监听器在以下场景中特别有用：

系统监控：实时监控调度器的运行状态
审计日志：记录调度器的重要操作事件
异常处理：捕获调度器级别的错误并进行处理
资源管理：在调度器关闭时执行清理操作

核心事件详解

调度器监听器接口定义了多种事件回调方法，下面我们详细解析每个方法的作用：

1. JobScheduled(Trigger trigger)

当一个新的作业和触发器被调度时触发。参数包含被调度的触发器对象。

2. JobUnscheduled(string triggerName, string triggerGroup)

当触发器被取消调度时触发。参数包含被取消的触发器名称和组名。

3. TriggerFinalized(Trigger trigger)

当触发器不再被触发且从调度器中移除时触发。通常表示触发器已完成所有触发。

4. TriggersPaused/TriggersResumed

这两个方法分别在触发器被暂停和恢复时触发。

5. JobsPaused/JobsResumed

这两个方法分别在作业被暂停和恢复时触发。

6. SchedulerError(string msg, SchedulerException cause)

当调度器发生严重错误时触发。这是处理调度器级别异常的关键方法。

7. SchedulerShutdown()

当调度器关闭时触发。适合在此处执行资源释放等清理操作。

重要注意事项

异常处理：监听器方法必须妥善处理异常，任何未捕获的异常都可能导致调度器进入不可预测状态。
性能考量：监听器中的逻辑应尽量高效，避免阻塞调度器的主线程。
线程安全：监听器方法可能被多个线程同时调用，需要确保线程安全。

实战示例

下面展示如何实现并注册一个简单的调度器监听器：

public class MySchedulerListener : ISchedulerListener
{
    private readonly ILogger _logger;
    
    public MySchedulerListener(ILogger logger)
    {
        _logger = logger;
    }
    
    public async Task JobScheduled(Trigger trigger)
    {
        try
        {
            _logger.LogInformation($"作业已调度: {trigger.JobKey}");
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "处理JobScheduled事件时出错");
        }
    }
    
    // 实现其他接口方法...
}

// 注册监听器
var listener = new MySchedulerListener(logger);
scheduler.ListenerManager.AddSchedulerListener(listener);