Quartz.NET作业调度框架详解

最新推荐文章于 2023-09-08 16:24:21 发布

FeelUps

最新推荐文章于 2023-09-08 16:24:21 发布

阅读量786

点赞数

分类专栏： asp.net B Code

B Code 同时被 2 个专栏收录

89 篇文章

订阅专栏

asp.net

53 篇文章

订阅专栏

Quartz.NET是一个.NET移植的开源作业调度框架，提供强大的灵活性和简单性，支持复杂的调度需求，如数据库支持、集群和cron-like表达式等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Quartz.NET作业调度框架详解

Quartz.NET是一个开源的作业调度框架，是OpenSymphony 的 Quartz API的.NET移植，它用C#写成，可用于winform和asp.net应用中。它提供了巨大的灵活性而不牺牲简单性。你能够用它来为执行一个作业而创建简单的或复杂的调度。它有很多特征，如：数据库支持，集群，插件，支持cron-like表达式等等。

你曾经需要应用执行一个任务吗？这个任务每天或每周星期二晚上11：30，或许仅仅每个月的最后一天执行。一个自动执行而无须干预的任务在执行过程中如果发生一个严重错误，应用能够知到其执行失败并尝试重新执行吗？你和你的团队是用.NET编程吗？如果这些问题中任何一个你回答是，那么你应该使用Quartz.NET调度器。 Quartz.NET允许开发人员根据时间间隔（或天）来调度作业。它实现了作业和触发器的多对多关系，还能把多个作业与不同的触发器关联。整合了 Quartz.NET的应用程序可以重用来自不同事件的作业，还可以为一个事件组合多个作业.

Quartz.NET入门

要开始使用 Quartz.NET，需要用 Quartz.NET API 对项目进行配置。步骤如下：

1. 到http://quartznet.sourceforge.net/download.html下载 Quartz.NET API，最新版本是1.0.3

2. 解压缩Quartz.NET-1.0.3.zip 到目录，根据你的项目情况用Visual Studio 2005或者Visual Studio 2008打开相应工程，编译。你可以将它放进自己的应用中。Quartz.NET框架只需要少数的第三方库，并且这些三方库是必需的，你很可能已经在使用这些库了。

3. 在Quartz.NET有一个叫做quartz.properties的配置文件，它允许你修改框架运行时环境。缺省是使用Quartz.dll里面的quartz.properties文件。当然你可以在应用程序配置文件中做相应的配置，下面是一个配置文件示例：

           <?xml version=
           "1.0"
           encoding=
           "utf-8"
           ?>
          

           <configuration>
          

           <configSections>
          

           <section name=
           "quartz"
           type=
           "System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0,Culture=neutral, PublicKeyToken=b77a5c561934e089"
           />
          

           </configSections>
          

           <quartz>
          

           <add key=
           "quartz.scheduler.instanceName"
           value=
           "ExampleDefaultQuartzScheduler"
           />
          

           <add key=
           "quartz.threadPool.type"
           value=
           "Quartz.Simpl.SimpleThreadPool, Quartz"
           />
          

           <add key=
           "quartz.threadPool.threadCount"
           value=
           "10" 
           />
          

           <add key=
           "quartz.threadPool.threadPriority"
           value=
           "2" 
           />
          

           <add key=
           "quartz.jobStore.misfireThreshold"
           value=
           "60000"
           />
          

           <add key=
           "quartz.jobStore.type"
           value=
           "Quartz.Simpl.RAMJobStore, Quartz"
           />
          

           </quartz>
          

           </configuration>
          

为了方便读者，我们使用Quartz.NET的例子代码来解释，现在来看一下 Quartz API 的主要组件。

调度器和作业

Quartz.NET框架的核心是调度器。调度器负责管理Quartz.NET应用运行时环境。调度器不是靠自己做所有的工作，而是依赖框架内一些非常重要的部件。Quartz不仅仅是线程和线程管理。为确保可伸缩性，Quartz.NET采用了基于多线程的架构。启动时，框架初始化一套worker线程，这套线程被调度器用来执行预定的作业。这就是Quartz.NET怎样能并发运行多个作业的原理。Quartz.NET依赖一套松耦合的线程池管理部件来管理线程环境。作业是一个执行任务的简单.NET类。任务可以是任何C#\VB.NET代码。只需你实现Quartz.IJob接口并且在出现严重错误情况下抛出JobExecutionException异常即可。

IJob接口包含唯一的一个方法Execute()，作业从这里开始执行。一旦实现了IJob接口和Execute ()方法，当Quartz.NET确定该是作业运行的时候，它将调用你的作业。Execute()方法内就完全是你要做的事情。

通过实现 Quartz.IJob接口，可以使 .NET 类变成可执行的。清单 1 提供了 Quartz.IJob作业的一个示例。这个类用一条非常简单的输出语句覆盖了 Execute(JobExecutionContext context) 方法。这个方法可以包含我们想要执行的任何代码（所有的代码示例都基于 Quartz.NET 1.0.3 ，它是编写这篇文章时的稳定发行版）。

清单 1：作业

           using 
            System;
          
           using 
            System.Collections.Generic;
          
           using 
            System.Text;
          
           using 
            Common.Logging;
          
           using 
            Quartz;
          
           namespace
           QuartzBeginnerExample
          
           {
          
           public
           class 
           SimpleQuartzJob : IJob
          
           {
          
           private
           static 
           ILog _log = LogManager.GetLogger(
           typeof
           (SimpleQuartzJob));
          
           /// <summary>
          
           /// Called by the <see cref="IScheduler" /> when a
          
           /// <see cref="Trigger" /> fires that is associated with
          
           /// the <see cref="IJob" />.
          
           /// </summary>
          
           public
           virtual 
           void
           Execute(JobExecutionContext context)
          
           {
          
           try
          
           {
          
           // This job simply prints out its job name and the
          
           // date and time that it is running
          
           string
           jobName = context.JobDetail.FullName;
          
           _log.Info(
           "Executing job: "
           + jobName + 
           " executing at "
           + DateTime.Now.ToString(
           "r"
           ));
          
           }
          
           catch
           (Exception e)
          
           {
          
           _log.Info(
           "--- Error in job!"
           );
          
           JobExecutionException e2 =
           new 
           JobExecutionException(e);
          
           // this job will refire immediately
          
           e2.RefireImmediately =
           true
           ;
          
           throw
           e2;
          
           }
          
           }
          
           }
          
           }