Quartz.NET 4.x 快速入门指南：从安装到第一个定时任务

崔暖荔

于 2025-06-06 09:07:16 发布

阅读量418

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00301/article/details/148465557

版权

Quartz.NET 4.x 快速入门指南：从安装到第一个定时任务

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

前言

Quartz.NET 是一个功能强大的开源作业调度库，专为 .NET 平台设计。它可以帮助开发人员在应用程序中实现各种定时任务，从简单的周期性任务到复杂的分布式作业调度都能胜任。本文将带你快速了解 Quartz.NET 4.x 的核心功能和使用方法。

环境准备

安装 Quartz.NET

Quartz.NET 提供了多种安装方式，最便捷的是通过 NuGet 包管理器：

在 Visual Studio 中右键点击项目引用
选择"管理 NuGet 程序包"
搜索"Quartz"并安装

或者使用 NuGet 命令行工具：

Install-Package Quartz

如果需要 JSON 序列化支持，可以额外安装：

Install-Package Quartz.Serialization.Json

基础配置

Quartz.NET 提供了灵活的配置方式，主要有两种途径：

1. 代码配置（Fluent API）

使用流畅的构建器 API 可以直观地配置调度器：

var properties = new NameValueCollection();

IScheduler scheduler = await SchedulerBuilder.Create(properties)
    .UseDefaultThreadPool(x => x.MaxConcurrency = 5)
    .UsePersistentStore(x =>
    {
        x.UseProperties = true;
        x.UseClustering();
        x.UseSqlServer("data-source", "connection-string");
        x.UseNewtonsoftJsonSerializer();
    })
    .UseXmlSchedulingConfiguration(x =>
    {
        x.Files = new[] { "~/quartz_jobs.xml" };
    })
    .BuildScheduler();

2. 配置文件

Quartz.NET 支持多种配置文件格式：

quartz.config 文件（推荐）
appsettings.json（.NET Core 项目）
YourApplication.exe.config（传统 .NET 项目）

示例 quartz.config 内容：

quartz.scheduler.instanceName = MyScheduler
quartz.jobStore.type = Quartz.Simpl.RAMJobStore, Quartz
quartz.threadPool.maxConcurrency = 3

第一个 Quartz.NET 应用

基础框架

创建一个简单的控制台应用程序：

using Quartz;
using Quartz.Impl;

public class Program
{
    public static async Task Main()
    {
        // 创建调度器工厂
        StdSchedulerFactory factory = new StdSchedulerFactory();
        IScheduler scheduler = await factory.GetScheduler();
        
        // 启动调度器
        await scheduler.Start();
        
        // 运行10秒后关闭
        await Task.Delay(TimeSpan.FromSeconds(10));
        await scheduler.Shutdown();
    }
}

添加日志支持

Quartz.NET 使用 Microsoft.Extensions.Logging 抽象：

var loggerFactory = LoggerFactory.Create(builder =>
{
    builder
        .SetMinimumLevel(LogLevel.Debug)
        .AddSimpleConsole(options => 
        {
            options.SingleLine = true;
            options.TimestampFormat = "hh:mm:ss ";
        });
});
LogProvider.SetLogProvider(loggerFactory);

创建示例任务

定义一个简单的作业类：

public class HelloJob : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        await Console.Out.WriteLineAsync("Hello from Quartz.NET!");
    }
}

调度任务执行

在 Main 方法中添加任务调度逻辑：

// 定义作业
IJobDetail job = JobBuilder.Create<HelloJob>()
    .WithIdentity("job1", "group1")
    .Build();

// 定义触发器（立即执行，每10秒重复）
ITrigger trigger = TriggerBuilder.Create()
    .WithIdentity("trigger1", "group1")
    .StartNow()
    .WithSimpleSchedule(x => x
        .WithIntervalInSeconds(10)
        .RepeatForever())
    .Build();

// 调度作业
await scheduler.ScheduleJob(job, trigger);