在 ASP.NET Core和Worker Service中使用Quartz.Net

如今有了一个官方包Quartz.Extensions.Hosting实现使用Quartz.Net运行后台任务，因此把Quartz.Net添加到ASP.NET Core或Worker Service要简单得多。

我将展现如何把Quartz.Net HostedService添加到你的应用，如何建立一个简单的IJob，以及如何注册它与trigger。

简介——什么是Quartz.Net

Quartz.Net是一个功能齐全的开源做业调度系统，能够在最小规模的应用程序到大型企业系统使用。

有许多ASP.NET的钉子户，他们以一种可靠的、集群的方式在定时器上运行后台任务。使用在ASP.NET Core中使用的Quartz.Net支持了.NET Standar 2.0，所以你能够轻松地在应用程序中使用它。

Quartz.Net有三个主要概念:

1. job。这是你想要运行的后台任务。
2. trigger。trigger控制job什么时候运行，一般按某种调度规则触发。
3. scheduler。它负责协调job和trigger，根据trigger的要求执行job。

ASP.NET Core很好地支持经过hosted services（托管服务）运行“后台任务”。当你的ASP.NET Core应用程序启动，托管服务也启动，并在应用程序的生命周期中在后台运行。Quartz.Net 3.2.0经过Quartz.Extensions.Hosting引入了对该模式的直接支持。Quartz.Extensions.Hosting便可以用在ASP.NET Core应用程序，也能够用在基于“通用主机”的Worker Service。

虽然能够建立一个“定时”后台服务(例如，每10分钟运行一个任务)，但Quartz.NET提供了一个更加健壮的解决方案。经过使用Cron trigger，你能够确保任务只在一天的特定时间(例如凌晨2:30)运行，或者只在特定的日子运行，或者这些时间的任意组合运行。Quartz.Net还容许你以集群的方式运行应用程序的多个实例，以便在任什么时候候只有一个实例能够运行给定的任务。

Quartz.Net托管服务负责Quartz的调度。它将在应用程序的后台运行，检查正在执行的触发器，并在必要时运行相关的做业。你须要配置调度程序，但不须要担忧启动或中止它，IHostedService会为你管理。

在这篇文章中，我将展现建立Quartz.Net job的基础知识。并将其调度到托管服务中的定时器上运行。

安装Quartz.Net

Quartz.Net是一个.NET Standar 2.0的NuGet包，因此它很容易安装在你的应用程序中。对于这个测试，我建立了一个Worker Service项目。你能够经过使用dotnet add package Quartz.Extensions.Hosting命令安装Quartz.Net托管包。若是你查看项目的.csproj，它应该是这样的:

<Project Sdk="Microsoft.NET.Sdk.Worker">
  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    <UserSecretsId>dotnet-QuartzWorkerService-9D4BFFBE-BE06-4490-AE8B-8AF1466778FD</UserSecretsId>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Hosting" Version="5.0.0" />
    <PackageReference Include="Quartz.Extensions.Hosting" Version="3.2.3" />
  </ItemGroup>
</Project>

这将添加托管服务包，从而引入Quartz.Net。接下来，咱们须要在应用程序中注册Quartz.Net的服务和 IHostedService。

添加Quartz.Net托管服务

注册Quartz.Net须要作两件事：

1. 注册Quartz.Net须要的DI容器服务。
2. 注册托管服务。

在ASP.NET Core中，一般会在Startup.ConfigureServices()方法中完成这两项操做。Worker Services不使用Startup类，因此咱们在Program.cs中的IHostBuilder的ConfigureServices方法中注册它们:

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureServices((hostContext, services) =>
            {
                // Add the required Quartz.NET services
                services.AddQuartz(q =>
                {
                    // Use a Scoped container to create jobs. I'll touch on this later
                    q.UseMicrosoftDependencyInjectionScopedJobFactory();
                });

                // Add the Quartz.NET hosted service

                services.AddQuartzHostedService(
                    q => q.WaitForJobsToComplete = true);

                // other config
            });
}

这里有几个有趣的点:

1. UseMicrosoftDependencyInjectionScopedJobFactory:它告诉Quartz.NET注册一个IJobFactory，该IJobFactory经过从DI容器中建立job。方法中的Scoped部分意味着你的做业可使用scoped服务，而不只仅是single或transient服务。
2. WaitForJobsToComplete:此设置确保当请求关闭时，Quartz.NET在退出以前等待做业优雅地结束。

若是你如今运行应用程序，将看到Quartz服务启动，并将大量日志转储到控制台:

info: Quartz.Core.SchedulerSignalerImpl[0]
      Initialized Scheduler Signaller of type: Quartz.Core.SchedulerSignalerImpl
info: Quartz.Core.QuartzScheduler[0]
      Quartz Scheduler v.3.2.3.0 created.
info: Quartz.Core.QuartzScheduler[0]
      JobFactory set to: Quartz.Simpl.MicrosoftDependencyInjectionJobFactory
info: Quartz.Simpl.RAMJobStore[0]
      RAMJobStore initialized.
info: Quartz.Core.QuartzScheduler[0]
      Scheduler meta-data: Quartz Scheduler (v3.2.3.0) 'QuartzScheduler' with instanceId 'NON_CLUSTERED'
  Scheduler class: 'Quartz.Core.QuartzScheduler' - running locally.
  NOT STARTED.
  Currently in standby mode.
  Number of jobs executed: 0
  Using thread pool 'Quartz.Simpl.DefaultThreadPool' - with 10 threads.
  Using job-store 'Quartz.Simpl.RAMJobStore' - which does not support persistence. and is not clustered.

info: Quartz.Impl.StdSchedulerFactory[0]
      Quartz scheduler 'QuartzScheduler' initialized
info: Quartz.Impl.StdSchedulerFactory[0]
      Quartz scheduler version: 3.2.3.0
info: Quartz.Core.QuartzScheduler[0]
      Scheduler QuartzScheduler_$_NON_CLUSTERED started.
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down....

此时，你已经让Quartz做为托管服务在你的应用程序中运行，可是没有任何job让它运行。在下一节中，咱们将建立并注册一个简单的job。

建立job

对于咱们正在调度的实际后台工做，咱们将使用一个"hello world"实现它写入一个ILogger<T>。你应该实现Quartz.NET的接口IJob，它包含一个异步的Execute()方法。注意，咱们在这里使用依赖注入将日志程序注入到构造函数中。

using Microsoft.Extensions.Logging;
using Quartz;
using System.Threading.Tasks;
[DisallowConcurrentExecution]
public class HelloWorldJob : IJob
{
    private readonly ILogger<HelloWorldJob> _logger;
    public HelloWorldJob(ILogger<HelloWorldJob> logger)
    {
        _logger = logger;
    }

    public Task Execute(IJobExecutionContext context)
    {
        _logger.LogInformation("Hello world!");
        return Task.CompletedTask;
    }
}

我还用[DisallowConcurrentExecution]属性装饰了job。此属性防止Quartz.NET试图同时运行相同的做业。

如今咱们已经建立了做业，咱们须要将它与trigger一块儿注册到DI容器中。

配置job

Quartz.NET为运行job提供了一些简单的schedule，但最多见的方法之一是使用Quartz.NET Cron表达式。Cron表达式容许复杂的计时器调度，因此你能够设置规则，好比“每月的5号和20号，在早上8点到10点之间每半小时触发一次”。使用时请确保检查示例文档，由于不一样系统使用的全部Cron表达式都是可互换的。

下面的示例展现了如何使用每5秒运行一次的trggier来注册HelloWorldJob:

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureServices((hostContext, services) =>
        {
            services.AddQuartz(q =>  
            {
                q.UseMicrosoftDependencyInjectionScopedJobFactory();

                // Create a "key" for the job
                var jobKey = new JobKey("HelloWorldJob");

                // Register the job with the DI container
                q.AddJob<HelloWorldJob>(opts => opts.WithIdentity(jobKey));

                // Create a trigger for the job
                q.AddTrigger(opts => opts
                    .ForJob(jobKey) // link to the HelloWorldJob
                    .WithIdentity("HelloWorldJob-trigger") // give the trigger a unique name
                    .WithCronSchedule("0/5 * * * * ?")); // run every 5 seconds

            });
            services.AddQuartzHostedService(q => q.WaitForJobsToComplete = true);
            // ...
        });

在本代码中，咱们:

1. 为job建立惟一的JobKey。这用于将job与其trggier链接在一块儿。还有其余链接job和trggier的方法，但我认为这和其余方法同样好。
2. 用AddJob<T>注册HelloWorldJob。这作了两件事—它将HelloWorldJob添加到DI容器中，这样就能够建立它;它在内部向Quartz注册job。
3. 添加一个触发器，每5秒运行一次做业。咱们使用JobKey将trigger与一个job关联起来，并为trigger提供惟一的名称(在本例中不是必需的，但若是你在集群模式下运行quartz，这很重要)。最后，咱们为trigger设置了Cron调度，使做业每5秒运行一次。

这就实现了功能!再也不须要建立自定义的IJobFactory，也不用担忧是否支持scoped的服务。

默认的包为你处理全部这些问题——你能够在IJob中使用scoped的服务，它们将在job完成时被删除。

若是你如今运行你的应用程序，你会看到和之前同样的启动消息，而后每5秒你会看到HelloWorldJob写入控制台:

​

这就是启动和运行所需的所有内容，可是根据个人喜爱，在ConfigureServices方法中添加了太多内容。你也不太可能想在应用程序中硬编码做业调度。例如，若是将其提取到配置中，能够在每一个环境中使用不一样的调度。

最起码，咱们但愿将Cron调度提取到配置中。例如，你能够在appsettings.json中添加如下内容:

{
  "Quartz": {
    "HelloWorldJob": "0/5 * * * * ?"
  }
}

而后，你能够轻松地在不一样环境中覆盖HelloWorldJob的触发器调度。

为了方便注册，咱们能够建立一个扩展方法来封装在Quartz上注册IJob，并设置它的trigger调度。这段代码与前面的示例基本相同，可是它使用job的名称在IConfiguration中加载Cron调度。

public static class ServiceCollectionQuartzConfiguratorExtensions{
    public static void AddJobAndTrigger<T>(
        this IServiceCollectionQuartzConfigurator quartz,
        IConfiguration config)
        where T : IJob
    {
        // Use the name of the IJob as the appsettings.json key
        string jobName = typeof(T).Name;

        // Try and load the schedule from configuration
        var configKey = $"Quartz:{jobName}";
        var cronSchedule = config[configKey];

        // Some minor validation
        if (string.IsNullOrEmpty(cronSchedule))
        {
            throw new Exception($"No Quartz.NET Cron schedule found for job in configuration at {configKey}");
        }

        // register the job as before
        var jobKey = new JobKey(jobName);
        quartz.AddJob<T>(opts => opts.WithIdentity(jobKey));

        quartz.AddTrigger(opts => opts
            .ForJob(jobKey)
            .WithIdentity(jobName + "-trigger")
            .WithCronSchedule(cronSchedule)); // use the schedule from configuration
    }
}

如今咱们可使用扩展方法清理应用程序的Program.cs:

public class Program
{
    public static void Main(string[] args) => CreateHostBuilder(args).Build().Run();

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureServices((hostContext, services) =>
            {
                services.AddQuartz(q =>
                {
                    q.UseMicrosoftDependencyInjectionScopedJobFactory();

                    // Register the job, loading the schedule from configuration
                    q.AddJobAndTrigger<HelloWorldJob>(hostContext.Configuration);
                });

                services.AddQuartzHostedService(q => q.WaitForJobsToComplete = true);
            });
}

这本质上与咱们的配置相同，可是咱们已经使添加新job和调度的细节移到配置中变得更容易。

再次运行应用程序会给出相同的输出:job每5秒写一次输出。

​

总结

在这篇文章中，我介绍了Quartz.NET并展现了如何使用新的Quartz.Extensions.Hosting轻松添加一个ASP.NET Core托管服务运行Quartz调度器。我展现了如何使用trigger实现一个简单的job，以及如何将其注册到应用程序中，以便托管的服务按计划运行它。

 欢迎关注个人公众号，若是你有喜欢的外文技术文章，能够经过公众号留言推荐给我。

​

原文连接：https://andrewlock.net/using-quartz-net-with-asp-net-core-and-worker-services/