在ASP.NET Core中创建基于Quartz.NET托管服务轻松实现作业调度

在这篇文章中，我将介绍如何使用asp.net core托管服务运行quartz.net作业。这样的好处是我们可以在应用程序启动和停止时很方便的来控制我们的job的运行状态。接下来我将演示如何创建一个简单的 ijob，一个自定义的 ijobfactory和一个在应用程序运行时就开始运行的quartzhostedservice。我还将介绍一些需要注意的问题，即在单例类中使用作用域服务。

作者：依乐祝

首发地址：

参考英文地址：

简介-什么是quartz.net？

在开始介绍什么是quartz.net前先看一下下面这个图，这个图基本概括了quartz.net的所有核心内容。

注：此图为百度上获取，旨在学习交流使用，如有侵权，联系后删除。

以下来自的描述：

quartz.net是功能齐全的开源作业调度系统，适用于从最小型的应用程序到大型企业系统。

对于许多asp.net开发人员来说它是首选，用作在计时器上以可靠、集群的方式运行后台任务的方法。将quartz.net与asp.net core一起使用也非常相似-因为quartz.net支持.net standard 2.0，因此您可以轻松地在应用程序中使用它。

quartz.net有两个主要概念：

• job。这是您要按某个特定时间表运行的后台任务。
• scheduler。这是负责基于触发器，基于时间的计划运行作业。

asp.net core通过对运行“后台任务”具有良好的支持。托管服务在asp.net core应用程序启动时启动，并在应用程序生命周期内在后台运行。通过创建quartz.net托管服务，您可以使用标准asp.net core应用程序在后台运行任务。

虽然可以创建（例如，每10分钟运行一次任务），但quartz.net提供了更为强大的解决方案。通过使用cron触发器，您可以确保任务仅在一天的特定时间（例如，凌晨2:30）运行，或仅在特定的几天运行，或任意组合运行。它还允许您以集群方式运行应用程序的多个实例，以便在任何时候只能运行一个实例（高可用）。

在本文中，我将介绍创建quartz.net作业的基本知识并将其调度为在托管服务中的计时器上运行。

安装quartz.net

quartz.net是.net standard 2.0 nuget软件包，因此非常易于安装在您的应用程序中。对于此测试，我创建了一个asp.net core项目并选择了empty模板。您可以使用dotnet add package quartz来安装quartz.net软件包。这时候查看该项目的.csproj，应如下所示：

<project sdk="microsoft.net.sdk.web">

  <propertygroup>
    <targetframework>netcoreapp3.1</targetframework>
  </propertygroup>

  <itemgroup>
    <packagereference include="quartz" version="3.0.7" />
  </itemgroup>

</project>

创建一个ijob

对于我们正在安排的实际后台工作，我们将通过向注入的ilogger<>中写入“ hello world”来进行实现进而向控制台输出结果）。您必须实现包含单个异步execute()方法的quartz接口ijob。请注意，这里我们使用依赖注入将日志记录器注入到构造函数中。

using microsoft.extensions.logging;
using quartz;
using system;
using system.threading.tasks;

namespace quartzhostedservice
{
    [disallowconcurrentexecution]
    public class helloworldjob : ijob
    {
        private readonly ilogger<helloworldjob> _logger;

        public helloworldjob(ilogger<helloworldjob> logger)
        {
            _logger = logger ?? throw new argumentnullexception(nameof(logger));
        }

        public task execute(ijobexecutioncontext context)
        {
            _logger.loginformation("hello world by yilezhu at {0}!",datetime.now.tostring("yyyy-mm-dd hh:mm:ss"));
            return task.completedtask;
        }
    }
}

我还用[disallowconcurrentexecution]属性装饰了该作业。该属性可防止quartz.net尝试同时运行同一作业。

创建一个ijobfactory

接下来，我们需要告诉quartz如何创建ijob的实例。默认情况下，quartz将使用activator.createinstance创建作业实例，从而有效的调用new helloworldjob()。不幸的是，由于我们使用构造函数注入，因此无法正常工作。相反，我们可以提供一个自定义的ijobfactory挂钩到asp.net core依赖项注入容器（iserviceprovider）中：

using microsoft.extensions.dependencyinjection;
using quartz;
using quartz.spi;
using system;

namespace quartzhostedservice
{
    public class singletonjobfactory : ijobfactory
    {
        private readonly iserviceprovider _serviceprovider;

        public singletonjobfactory(iserviceprovider serviceprovider)
        {
            _serviceprovider = serviceprovider ?? throw new argumentnullexception(nameof(serviceprovider));
        }

        public ijob newjob(triggerfiredbundle bundle, ischeduler scheduler)
        {
            return _serviceprovider.getrequiredservice(bundle.jobdetail.jobtype) as ijob;
        }

        public void returnjob(ijob job)
        {
            
        }
    }
}

该工厂将一个iserviceprovider传入构造函数中，并实现ijobfactory接口。这里最重要的方法是newjob()方法。在这个方法中工厂必须返回quartz调度程序所请求的ijob。在此实现中，我们直接委托给iserviceprovider，并让di容器找到所需的实例。由于getrequiredservice的非泛型版本返回的是一个对象，因此我们必须在末尾将其强制转换成ijob。

该returnjob方法是调度程序尝试返回（即销毁）工厂创建的作业的地方。不幸的是，使用内置的iserviceprovider没有这样做的机制。我们无法创建适合quartz api所需的新的iscopeservice，因此我们只能创建单例作业。

这个很重要。使用上述实现，仅对创建单例（或瞬态）的ijob实现是安全的。

配置作业

我在ijob这里仅显示一个实现，但是我们希望quartz托管服务是适用于任何数量作业的通用实现。为了解决这个问题，我们创建了一个简单的dto jobschedule，用于定义给定作业类型的计时器计划：

using system;
using system.componentmodel;

namespace quartzhostedservice
{
    /// <summary>
    /// job调度中间对象
    /// </summary>
    public class jobschedule
    {
        public jobschedule(type jobtype, string cronexpression)
        {
            this.jobtype = jobtype ?? throw new argumentnullexception(nameof(jobtype));
            cronexpression = cronexpression ?? throw new argumentnullexception(nameof(cronexpression));
        }
        /// <summary>
        /// job类型
        /// </summary>
        public type jobtype { get; private set; }
        /// <summary>
        /// cron表达式
        /// </summary>
        public string cronexpression { get; private set; }
        /// <summary>
        /// job状态
        /// </summary>
        public jobstatus jobstatu { get; set; } = jobstatus.init;
    }

    /// <summary>
    /// job运行状态
    /// </summary>
    public enum jobstatus:byte
    {
        [description("初始化")]
        init=0,
        [description("运行中")]
        running=1,
        [description("调度中")]
        scheduling = 2,
        [description("已停止")]
        stopped = 3,

    }
}

这里的jobtype是该作业的.net类型（在我们的例子中就是helloworldjob），并且cronexpression是一个quartz.net的cron表达。cron表达式允许复杂的计时器调度，因此您可以设置下面复杂的规则，例如“每月5号和20号在上午8点至10点之间每半小时触发一次”。只需确保即可，因为并非所有操作系统所使用的cron表达式都是可以互换的。

我们将作业添加到di并在startup.configureservices()中配置其时间表：

using microsoft.aspnetcore.builder;
using microsoft.aspnetcore.hosting;
using microsoft.aspnetcore.http;
using microsoft.extensions.dependencyinjection;
using microsoft.extensions.hosting;
using quartz;
using quartz.impl;
using quartz.spi;

namespace quartzhostedservice
{
    public class startup
    {
        public void configureservices(iservicecollection services)
        {
            //添加quartz服务
            services.addsingleton<ijobfactory, singletonjobfactory>();
            services.addsingleton<ischedulerfactory, stdschedulerfactory>();
            //添加我们的job
            services.addsingleton<helloworldjob>();
            services.addsingleton(
                 new jobschedule(jobtype: typeof(helloworldjob), cronexpression: "0/5 * * * * ?")
           );
        }
        public void configure(iapplicationbuilder app, iwebhostenvironment env)
        {
           ......
        }
    }
}

此代码将四个内容作为单例添加到di容器：

• singletonjobfactory 是前面介绍的，用于创建作业实例。
• 一个ischedulerfactory的实现，使用内置的stdschedulerfactory，它可以处理调度和管理作业
• 该helloworldjob作业本身
• 一个类型为helloworldjob，并包含一个五秒钟运行一次的cron表达式的jobschedule的实例化对象。

现在我们已经完成了大部分基础工作，只缺少一个将他们组合在一起的、quartzhostedservice了。

创建quartzhostedservice

该quartzhostedservice是ihostedservice的一个实现，设置了quartz调度程序，并且启用它并在后台运行。由于quartz的设计，我们可以在ihostedservice中直接实现它，而不是从基backgroundservice类派生更常见的方法。该服务的完整代码在下面列出，稍后我将对其进行详细描述。

using microsoft.extensions.hosting;
using quartz;
using quartz.spi;
using system;
using system.collections.generic;
using system.threading;
using system.threading.tasks;

namespace quartzhostedservice
{
    public class quartzhostedservice : ihostedservice
    {
        private readonly ischedulerfactory _schedulerfactory;
        private readonly ijobfactory _jobfactory;
        private readonly ienumerable<jobschedule> _jobschedules;

        public quartzhostedservice(ischedulerfactory schedulerfactory, ijobfactory jobfactory, ienumerable<jobschedule> jobschedules)
        {
            _schedulerfactory = schedulerfactory ?? throw new argumentnullexception(nameof(schedulerfactory));
            _jobfactory = jobfactory ?? throw new argumentnullexception(nameof(jobfactory));
            _jobschedules = jobschedules ?? throw new argumentnullexception(nameof(jobschedules));
        }
        public ischeduler scheduler { get; set; }

        public async task startasync(cancellationtoken cancellationtoken)
        {
            scheduler = await _schedulerfactory.getscheduler(cancellationtoken);
            scheduler.jobfactory = _jobfactory;
            foreach (var jobschedule in _jobschedules)
            {
                var job = createjob(jobschedule);
                var trigger = createtrigger(jobschedule);
                await scheduler.schedulejob(job, trigger, cancellationtoken);
                jobschedule.jobstatu = jobstatus.scheduling;
            }
            await scheduler.start(cancellationtoken);
            foreach (var jobschedule in _jobschedules)
            {
                jobschedule.jobstatu = jobstatus.running;
            }
        }

        public async task stopasync(cancellationtoken cancellationtoken)
        {
            await scheduler?.shutdown(cancellationtoken);
            foreach (var jobschedule in _jobschedules)
            {
             
                jobschedule.jobstatu = jobstatus.stopped;
            }
        }

        private static ijobdetail createjob(jobschedule schedule)
        {
            var jobtype = schedule.jobtype;
            return jobbuilder
                .create(jobtype)
                .withidentity(jobtype.fullname)
                .withdescription(jobtype.name)
                .build();
        }

        private static itrigger createtrigger(jobschedule schedule)
        {
            return triggerbuilder
                .create()
                .withidentity($"{schedule.jobtype.fullname}.trigger")
                .withcronschedule(schedule.cronexpression)
                .withdescription(schedule.cronexpression)
                .build();
        }
    }
}

该quartzhostedservice有三个依存依赖项：我们在startup中配置的ischedulerfactory和ijobfactory，还有一个就是ienumerable<jobschedule>。我们仅向di容器中添加了一个jobschedule对象（即helloworldjob），但是如果您在di容器中注册更多的工作计划，它们将全部注入此处（当然，你也可以通过数据库来进行获取，再加以ui控制，是不是就实现了一个可视化的后台调度了呢？自己想象吧~）。

startasync方法将在应用程序启动时被调用，因此这里就是我们配置quartz的地方。我们首先一个ischeduler的实例，将其分配给属性以供后面使用，然后将注入的jobfactory实例设置给调度程序：

 public async task startasync(cancellationtoken cancellationtoken)
        {
            scheduler = await _schedulerfactory.getscheduler(cancellationtoken);
            scheduler.jobfactory = _jobfactory;
            ...
        }

接下来，我们循环注入作业计划，并为每一个作业使用在类的结尾处定义的createjob和createtrigger辅助方法在创建一个quartz的ijobdetail和itrigger。如果您不喜欢这部分的工作方式，或者需要对配置进行更多控制，则可以通过按需扩展jobscheduledto 来轻松自定义它。

public async task startasync(cancellationtoken cancellationtoken)
{
    // ...
   foreach (var jobschedule in _jobschedules)
            {
                var job = createjob(jobschedule);
                var trigger = createtrigger(jobschedule);
                await scheduler.schedulejob(job, trigger, cancellationtoken);
                jobschedule.jobstatu = jobstatus.scheduling;
            }
    // ...
}

private static ijobdetail createjob(jobschedule schedule)
{
    var jobtype = schedule.jobtype;
    return jobbuilder
        .create(jobtype)
        .withidentity(jobtype.fullname)
        .withdescription(jobtype.name)
        .build();
}

private static itrigger createtrigger(jobschedule schedule)
{
    return triggerbuilder
        .create()
        .withidentity($"{schedule.jobtype.fullname}.trigger")
        .withcronschedule(schedule.cronexpression)
        .withdescription(schedule.cronexpression)
        .build();
}

最后，一旦所有作业都被安排好，您就可以调用它的scheduler.start()来在后台实际开始quartz.net计划程序的处理。当应用程序关闭时，框架将调用stopasync()，此时您可以调用scheduler.stop()以安全地关闭调度程序进程。

public async task stopasync(cancellationtoken cancellationtoken)
{
    await scheduler?.shutdown(cancellationtoken);
}

您可以使用addhostedservice()扩展方法在托管服务startup.configureservices中注入我们的后台服务：

public void configureservices(iservicecollection services)
{
    // ...
    services.addhostedservice<quartzhostedservice>();
}

如果运行该应用程序，则应该看到每隔5秒运行一次后台任务并写入控制台中（或配置日志记录的任何地方）

在作业中使用作用域服务

这篇文章中描述的实现存在一个大问题：您只能创建singleton或transient作业。这意味着您不能使用注册为作用域服务的任何依赖项。例如，您将无法将ef core的 databasecontext注入您的ijob实现中，因为您会遇到captive dependency问题。

解决这个问题也不是很难：您可以注入iserviceprovider并创建自己的作用域。例如，如果您需要在helloworldjob中使用作用域服务，则可以使用以下内容：

public class helloworldjob : ijob
{
    // 注入di provider
    private readonly iserviceprovider _provider;
    public helloworldjob( iserviceprovider provider)
    {
        _provider = provider;
    }

    public task execute(ijobexecutioncontext context)
    {
        // 创建一个新的作用域
        using(var scope = _provider.createscope())
        {
            // 解析你的作用域服务
            var service = scope.serviceprovider.getservice<iscopedservice>();
            _logger.loginformation("hello world by yilezhu at {0}!",datetime.now.tostring("yyyy-mm-dd hh:mm:ss"));
        }

        return task.completedtask;
    }
}

这样可以确保在每次运行作业时都创建一个新的作用域，因此您可以在ijob中检索（并处理）作用域服务。糟糕的是，这样的写法确实有些混乱。在下一篇文章中，我将展示另一种比较优雅的实现方式，它更简洁，有兴趣的可以关注下“dotnetcore实战”公众号第一时间获取更新。

总结

在这篇文章中，我介绍了quartz.net，并展示了如何使用它在asp.net core中的ihostedservice中来调度后台作业。这篇文章中显示的示例最适合单例或瞬时作业，这并不理想，因为使用作用域服务显得很笨拙。在下一篇文章中，我将展示另一种比较优雅的实现方式，它更简洁，并使得使用作用域服务更容易,有兴趣的可以关注下“dotnetcore实战”公众号第一时间获取更新。