Quartz.NET 多触发器配置实战指南

杭律沛Meris

于 2025-06-06 09:06:50 发布

阅读量384

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00053/article/details/148465497

Quartz.NET 多触发器配置实战指南

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

理解 Quartz.NET 的多触发器机制

Quartz.NET 作为一个功能强大的作业调度库，提供了灵活的触发器配置方式。其中，为单个作业配置多个触发器是一个非常实用的特性，它允许我们为同一个作业逻辑创建不同的执行计划，同时还能为每个触发器携带特定的参数。

基础概念解析

作业(Job)与触发器(Trigger)的关系

在 Quartz.NET 中，作业和触发器是两个独立但紧密关联的概念：

作业(Job)：定义了要执行的具体任务逻辑
触发器(Trigger)：定义了作业的执行时间和频率

一个作业可以被多个触发器关联，这意味着同一个业务逻辑可以根据不同的时间安排或参数配置多次执行。

数据合并机制

Quartz.NET 提供了智能的数据合并策略：

作业可以携带基础数据(JobDataMap)
每个触发器可以携带自己的特定数据(Trigger的JobDataMap)
执行时，系统会自动合并这些数据，触发器数据会覆盖作业中的同名数据

实战示例

基础多触发器配置

让我们看一个简单的客户处理作业示例：

public class HelloJob : IJob
{
    public static readonly JobKey Key = new JobKey("customer-process", "group");

    public async Task Execute(IJobExecutionContext context)
    {
        // 从合并后的数据中获取参数
        var customerId = context.MergedJobDataMap.GetString("CustomerId");
        var batchSize = context.MergedJobDataMap.GetString("batch-size");

        await Console.WriteLineAsync($"CustomerId={customerId} batch-size={batchSize}");
    }
}

配置两个触发器：

public async Task ConfigureTriggers(IScheduler scheduler, CancellationToken ct)
{
    // 创建作业
    var job = JobBuilder.Create<HelloJob>()
                       .WithIdentity(HelloJob.Key)
                       .Build();
    
    // 添加作业到调度器
    await scheduler.AddJob(job, replace: true, storeNonDurableWhileAwaitingScheduling: true, ct);

    // 触发器1 - 处理客户1
    var jobData1 = new JobDataMap { { "CustomerId", "1" } };
    await scheduler.TriggerJob(HelloJob.Key, jobData1, ct);

    // 触发器2 - 处理客户2
    var jobData2 = new JobDataMap { { "CustomerId", "2" } };
    await scheduler.TriggerJob(HelloJob.Key, jobData2, ct);
}

执行结果：

CustomerId=1 batch-size=
CustomerId=2 batch-size=

作业级数据与触发器数据结合

更实用的场景是在作业中设置公共参数，在触发器中设置特定参数：

public async Task ConfigureTriggersWithCommonData(IScheduler scheduler, CancellationToken ct)
{
    // 创建作业并设置公共参数
    var job = JobBuilder.Create<HelloJob>()
                       .WithIdentity(HelloJob.Key)
                       .UsingJobData("batch-size", "50") // 作业级公共参数
                       .Build();
    
    await scheduler.AddJob(job, replace: true, storeNonDurableWhileAwaitingScheduling: true, ct);

    // 触发器1 - 处理客户1
    var jobData1 = new JobDataMap { { "CustomerId", "1" } };
    await scheduler.TriggerJob(HelloJob.Key, jobData1, ct);

    // 触发器2 - 处理客户2
    var jobData2 = new JobDataMap { { "CustomerId", "2" } };
    await scheduler.TriggerJob(HelloJob.Key, jobData2, ct);
}

执行结果：

CustomerId=1 batch-size=50
CustomerId=2 batch-size=50

高级应用场景

参数优先级策略

理解数据合并的优先级很重要：

触发器参数 > 作业参数
后添加的触发器参数 > 先添加的触发器参数

动态触发器配置

在实际应用中，我们经常需要根据业务需求动态创建触发器：

public async Task ConfigureDynamicTriggers(IScheduler scheduler, List<string> customerIds, CancellationToken ct)
{
    // 创建基础作业
    var job = JobBuilder.Create<HelloJob>()
                       .WithIdentity(HelloJob.Key)
                       .UsingJobData("batch-size", "100")
                       .Build();
    
    await scheduler.AddJob(job, replace: true, storeNonDurableWhileAwaitingScheduling: true, ct);

    // 为每个客户创建触发器
    foreach (var customerId in customerIds)
    {
        var triggerData = new JobDataMap { { "CustomerId", customerId } };
        await scheduler.TriggerJob(HelloJob.Key, triggerData, ct);
    }
}