C#测试控制台程序调用Quartz.NET的基本用法

Quartz.Net是常用的任务调用框架之一，既能在客户端程序中使用，也支持在网页程序后台调用。本文结合参考文献4中的示例代码学习其在控制台程序中的基本用法。
VS2022新建控制台项目，在Nuget包管理器中搜索并安装Quartz包，如下所示：

Quartz.NET最基本的三个对象，调度器、触发器及作业。其中：
1）调度器（Scheduler）：用于保存并运行作业；
2）触发器（Trigger）：定义作业的运行规则，一次性、周期性调用等；
3）作业（Job）：需要一次性或周期性执行的操作，需要集成IJob接口，实现其中的Execute函数，从参考文献4的示例来看，一个作业匹配一个触发器，调度器支持调度带不同触发器的作业集合。
定义MyJob 作业类，支持生成随机数并计算其和后打印到控制台，代码如下所示：

csharp 复制代码

public class MyJob : IJob
{
    public Random m_random = new Random();
    public Task  Execute(IJobExecutionContext context)
    {
        int a = m_random.Next(0,100);
        int b = m_random.Next(0, 100);

        Console.WriteLine($"{DateTime.Now.ToString()}:{a} + {b} = {a + b}");

        return default;
    }
}

对着参考文献4，创建调度器示例：/font>

csharp 复制代码

StdSchedulerFactory sf = new StdSchedulerFactory();
IScheduler sched = await sf.GetScheduler();

如果是一次性任务且立即执行，则按如下代码执行即可，运行效果如下所示：

csharp 复制代码

IJobDetail job = JobBuilder.Create<MyJob>().Build();
ITrigger trigger = TriggerBuilder.Create().Build();

await sched.ScheduleJob(job, trigger);
await sched.Start();

Console.ReadLine();

await sched.Shutdown(true);

如果是一次性任务但需延后执行，则可在创建触发器时调用StartAt指定触发时间，但根据函数说明，也不是百分百按时执行，取决于调度器调度设置。

csharp 复制代码

ITrigger trigger = TriggerBuilder.Create()
           .StartAt(runTime)
           .Build();

如果是简单的、周期性地作业，则可在创建触发器时调用WithSimpleSchedule函数进行设置，从参考文献4的示例2来看（02_SchedulingCapabilitiesUsingSimpleTriggers），可以设置多种形式的调用频次（示例如下所示。SimpleScheduleBuilder类型中支持的运行规则不少，详细的介绍请见参考文献1、4和5。

csharp 复制代码

// 设置每隔十秒调用一次，重复调用20次
ITrigger trigger = TriggerBuilder.Create()
           .StartAt(runTime)
           .WithSimpleSchedule(x => x.WithIntervalInSeconds(10).WithRepeatCount(20))
           .Build();
// 还支持按小时、分钟、自定义时间间隔调用
WithIntervalInHours
WithIntervalInMinutes
WithInterval

//支持快捷函数
RepeatHourlyForever//每小时调用一次，不限次数
RepeatMinutelyForever//每分钟调用一次，不限次数
RepeatSecondlyForever//每秒调用一次，不限次数
RepeatHourlyForTotalCount//每小时一次，指定调用次数
RepeatMinutelyForTotalCount//每分钟一次，指定调用次数
RepeatSecondlyForTotalCount//每秒调用一次，指定调用次数

创建作业及触发器实例过程中还支持调用WithIdentity函数设置名称及分组，以便在调度器调度多个作业时加以区分及控制。参考文献4的示例2演示了同时调度（02_SchedulingCapabilitiesUsingSimpleTriggers）2个分组近10个作业的示例，还包括重新调度作业的示意，有兴趣的可以直接去学习及参考代码。

参考文献：

[1]https://github.com/quartznet/quartznet

[2]https://blog.csdn.net/liyou123456789/article/details/126575055

[3]https://blog.csdn.net/u014708596/article/details/132297020

[4]https://github.com/quartznet/quartznet/tree/main/src/Quartz.Examples

[5]https://www.quartz-scheduler.net/documentation/quartz-3.x/quick-start.html