Quartz.Net实现做业定时调度详解

时间  2019-11-17
标签 quartz.net quartz 实现 定时 调度 详解 栏目 Quartz 繁體版
原文   原文链接

Quartz

一、Quartz.NET介绍

Quartz.NET是一个强大、开源、轻量的做业调度框架，你可以用它来为执行一个做业而建立简单的或复杂的做业调度。它有不少特征，如：数据库支持，集群，插件，支持cron-like表达式等等。很是适合在平时的工做中，定时轮询数据库同步，定时邮件通知，定时处理数据等。html

Quartz.NET容许开发人员根据时间间隔（或天）来调度做业。它实现了做业和触发器的多对多关系，还能把多个做业与不一样的触发器关联。整合了 Quartz.NET的应用程序能够重用来自不一样事件的做业，还能够为一个事件组合多个做业。git

官网：www.quartz-scheduler.net/github

源码：github.com/quartznet/q…数据库

示例：www.quartz-scheduler.net/documentati…微信

Quartz.NET是一个强大、开源、轻量的做业调度框架，是 OpenSymphony 的 Quartz API 的.NET移植，用C#改写，可用于winform和Web应用中。它灵活而不复杂,你可以用它来为执行一个做业而建立简单的或复杂的做业调度。Quartz.NET 3.0 已经开始支持 .NET Core/.NET Standard 2.0。微信开发

体系结构

Job 为做业的接口，JobDetail 用来描述 Job 的实现类及其它相关的静态信息；Trigger 做为做业的定时管理工具，一个 Trigger 只能对应一个做业实例，而一个做业实例可对应多个 Trigger ；Scheduler 作为定时任务容器，它包含了全部触发器和做业，每一个 Scheduler 都存有 JobDetail 和 Trigger 的注册，一个 Scheduler 中能够注册多个 JobDetail 和多个 Trigger 。框架

二、依赖框架

引入框架的方法很是简单你能够直接用nuget管理包也能够在项目中添加引用。为了知足不一样客户的需求，本文以最简单的方式来说解在Visual Studio中如何正确使用Quartz.NET。jsp

2.一、使用Nuget添加使用

2.1.0、建立一个项目

建立一个新项目，能够是ASP.NET MVC、WebForms、Winforms、.NET Core等多种.Net项目，这里使用的是VS2017，建立了一个控制台应用项目。async

新建QuartzTest控制台项目

要使用Quartz.NET咱们须要安装Quartz.NET包，最简单的方式就是从Quartz.NET管网下载dll文件引用便可。本文咱们使用Nuget进行dll文件的引用与管理。要使用Nuget必须确保已经安装过，最简单的方式是经过VS“工具”菜单查看是否有程序包管理控制台，若是有说明已经安装过，以下图所示。分布式

工具菜单查看是否有程序包管理控制台

若是没有找到那咱们就要进行安装。

2.1.二、安装Nuget

新版本的Visual Studio默认状况是安装了Nuget的，如Visual Studio 2015+，若是没有安装，打开VS菜单“工具”->"扩展与更新"。

扩展和更新

在扩展与更新中搜索“nuget”，能够新安装或卸载后升级。

在扩展与更新中搜索“nuget”，能够新安装或卸载后升级

2.1.三、使用nuget安装Quartz.NET

点击“工具”->"NuGet包管理器"->“程序包管理器控制台”

程序包管理器控制台

输入安装包的命令：

Install-Package Quartz
复制代码

安装结果以下：

Install-Package Quartz

时包管理器中就下载了须要的程序集与相关文件，同时程序中也添加了引用。

packages-quartz

三、Quartz.NET应用

假定要实现每隔5秒钟向控制台记录当前时间。

由于这是一个控制台应用，我想一启动时就开始该项工做，这里咱们须要将代码写在static void Main(string[] args)方法中。

3.一、定义要执行的任务

定义一个类，实现Quartz.IJob接口，实现方法Execute，TimeJob.cs文件的代码以下：

using System;
using System.Threading.Tasks;

namespace QuartzTest
{
    using Quartz;

    public class TimeJob : IJob
    {
        /// <summary>
        /// 做业调度定时执行的方法
        /// </summary>
        /// <param name="context"></param>
        /// <returns></returns>
        public async Task Execute(IJobExecutionContext context)
        {
            await Console.Out.WriteLineAsync("Hello QuartzNet..." + DateTime.Now + Environment.NewLine);           
        }
    }
}
复制代码

3.二、建立一个调度器

调度器负责管理与控制任务的执行，在Main方法中添加以下代码：

//调度器
IScheduler scheduler;
//调度器工厂
ISchedulerFactory factory;

//建立一个调度器
factory = new StdSchedulerFactory();
scheduler = factory.GetScheduler();
scheduler.Start();
复制代码

3.三、建立一个任务对象

这个任务对象就是咱们将要执行的工做，job1是名称，group1是组名。 //二、建立一个任务 IJobDetail job = JobBuilder.Create().WithIdentity("job1", "group1").Build();

3.四、建立一个触发器

触发器定义了什么时间任务开始或每隔多久执行一次。

//三、建立一个触发器
//DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);
ITrigger trigger = TriggerBuilder.Create()
	.WithIdentity("trigger1", "group1")
	.WithCronSchedule("0/5 * * * * ?")     //5秒执行一次
	.Build();
复制代码

3.五、将任务与触发器添加到调度器中并执行

//四、将任务与触发器添加到调度器中
scheduler.ScheduleJob(job, trigger);
//五、开始执行
scheduler.Start();
复制代码

3.六、运行结果

运行结果

3.7 Main方法完整代码

using Quartz;
using Quartz.Impl;
using System;

namespace QuartzTest
{
    class Program
    {
        static void Main(string[] args)
        {
            //一、调度器
            ISchedulerFactory sf = new StdSchedulerFactory();
            IScheduler sched = sf.GetScheduler();
            //二、建立一个任务
            IJobDetail job = JobBuilder.Create<TimeJob>()
              .WithIdentity("job1", "group1")
              .Build();

            //三、建立一个触发器
            //DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);
            ITrigger trigger = TriggerBuilder.Create()
                .WithIdentity("trigger1", "group1")
                .WithCronSchedule("0/5 * * * * ?")     //5秒执行一次                                                      
                .Build();

            sched.ScheduleJob(job, trigger);
            //启动任务
            sched.Start();
        }
    }
}
复制代码

四、Quartz的cron表达式

 Cron表达式是一个字符串，字符串以5或6个空格隔开，分为6或7个域，每个域表明一个含义，Cron有以下两种语法格式：

  （1） Seconds Minutes Hours DayofMonth Month DayofWeek Year

  （2）Seconds Minutes Hours DayofMonth Month DayofWeek

结构

  corn从左到右（用空格隔开）：秒 分 小时 月份中的日期 月份 星期中的日期 年份（可为空）

  例  "0 0 12 ? * WED" 在每星期三下午12:00 执行（年份一般 省略）

Cron各字段的含义

Cron各字段的含义

通配符说明

星号(*)：可用在全部字段中，表示对应时间域的每个时刻，例如， 在分钟字段时，表示“每分钟”；

问号(?)：该字符只在日期和星期字段中使用，它一般指定为“无心义的值”，至关于点位符；

减号(-)：表达一个范围，如在小时字段中使用“10-12”，则表示从10到12点，即10,11,12；

逗号(,)：表达一个列表值，如在星期字段中使用“MON,WED,FRI”，则表示星期一，星期三和星期五；

斜杠(/)：x/y表达一个等步长序列，x为起始值，y为增量步长值。如在分钟字段中使用0/15，则表示为0,15,30和45秒，而5/15在分钟字段中表示5,20,35,50，你也可使用*/y，它等同于0/y；

L：该字符只在日期和星期字段中使用，表明“Last”的意思，但它在两个字段中意思不一样。L在日期字段中，表示这个月份的最后一天，如一月的31号，非闰年二月的28号；若是L用在星期中，则表示星期六，等同于7。可是，若是L出如今星期字段里，并且在前面有一个数值X，则表示“这个月的最后X天”，例如，6L表示该月的最后星期五；

W：该字符只能出如今日期字段里，是对前导日期的修饰，表示离该日期最近的工做日。例如15W表示离该月15号最近的工做日，若是该月15号是星期六，则匹配14号星期五；若是15日是星期日，则匹配16号星期一；若是15号是星期二，那结果就是15号星期二。但必须注意关联的匹配日期不可以跨月，如你指定1W，若是1号是星期六，结果匹配的是3号星期一，而非上个月最后的那天。W字符串只能指定单一日期，而不能指定日期范围；

LW组合：在日期字段能够组合使用LW，它的意思是当月的最后一个工做日；

井号(#)：该字符只能在星期字段中使用，表示当月某个工做日。如6#3表示当月的第三个星期五(6表示星期五，#3表示当前的第三个)，而4#5表示当月的第五个星期三，假设当月没有第五个星期三，忽略不触发；

C：该字符只在日期和星期字段中使用，表明“Calendar”的意思。它的意思是计划所关联的日期，若是日期没有被关联，则至关于日历中全部日期。例如5C在日期字段中就至关于日历5日之后的第一天。1C在星期字段中至关于星期往后的第一天。

Cron表达式对特殊字符的大小写不敏感，对表明星期的缩写英文大小写也不敏感。

一些例子：

表示式 说明

0 0 12 * * ? 天天12点运行

0 15 10 ? * * 天天10:15运行

0 15 10 * * ? 天天10:15运行

0 15 10 * * ? * 天天10:15运行

0 15 10 * * ? 2008 在2008年的天天10：15运行

0 * 14 * * ? 天天14点到15点之间每分钟运行一次，开始于14:00，结束于14:59。

0 0/5 14 * * ? 天天14点到15点每5分钟运行一次，开始于14:00，结束于14:55。

0 0/5 14,18 * * ? 天天14点到15点每5分钟运行一次，此外天天18点到19点每5钟也运行一次。

0 0-5 14 * * ? 天天14:00点到14:05，每分钟运行一次。

0 10,44 14 ? 3 WED 3月每周三的14:10分到14:44，每分钟运行一次。

0 15 10 ? * MON-FRI 每周一，二，三，四，五的10:15分运行。

0 15 10 15 * ? 每个月15日10:15分运行。

0 15 10 L * ? 每个月最后一天10:15分运行。

0 15 10 ? * 6L 每个月最后一个星期五10:15分运行。

0 15 10 ? * 6L 2007-2009 在2007,2008,2009年每月的最后一个星期五的10:15分运行。

0 15 10 ? * 6#3 每个月第三个星期五的10:15分运行。

注意：

（1）有些子表达式能包含一些范围或列表

  例如：子表达式（天（星期））能够为 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”

“*”字符表明全部可能的值

  所以，“”在子表达式（月）里表示每月的含义，“”在子表达式（天（星期））表示星期的每一天

  “/”字符用来指定数值的增量    例如：在子表达式（分钟）里的“0/15”表示从第0分钟开始，每15分钟  在子表达式（分钟）里的“3/20”表示从第3分钟开始，每20分钟（它和“3，23，43”）的含义同样

  “？”字符仅被用于天（月）和天（星期）两个子表达式，表示不指定值    当2个子表达式其中之一被指定了值之后，为了不冲突，须要将另外一个子表达式的值设为“？”

  “L” 字符仅被用于天（月）和天（星期）两个子表达式，它是单词“last”的缩写    可是它在两个子表达式里的含义是不一样的。    在天（月）子表达式中，“L”表示一个月的最后一天    在天（星期）自表达式中，“L”表示一个星期的最后一天，也就是SAT

  若是在“L”前有具体的内容，它就具备其余的含义了

  例如：“6L”表示这个月的倒数第６天，“FRIL”表示这个月的最一个星期五    注意：在使用“L”参数时，不要指定列表或范围，由于这会致使问题

表达式生成器 有不少的cron表达式在线生成器，这里给你们推荐几款 www.pdtools.net/tools/becro…

或者

cron.qqe2.com/

五、其余文章参考

一路走来数个年头，感谢RDIFramework.NET框架的支持者与使用者，你们能够经过下面的地址了解详情。

RDIFramework.NET官方网站：www.rdiframework.net/

RDIFramework.NET官方博客：blog.rdiframework.net/

同时须要说明的，之后的全部技术文章以官方网站为准，欢迎你们收藏！

RDIFramework.NET框架由专业团队长期打造、一直在更新、一直在升级，请放心使用！

欢迎关注RDIFramework.net框架官方公众微信（微信号：guosisoft），及时了解最新动态。

扫描二维码当即关注

file
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程