Quartz.NET是一个强大、开源、轻量的做业调度框架,是 OpenSymphony 的 Quartz API 的.NET移植,用C#改写,可用于winform和asp.net应用中。它灵活而不复杂。你可以用它来为执行一个做业而建立简单的或复杂的做业调度。它有不少特征,如:数据库支持,集群,插件,支持cron-like表达式等等。html
通俗说它的功能是:好比说我想天天晚上2点让程序或网站执行某些代码,或者每隔5秒种我想查看是否有新的任务要处理等。java
官网:http://www.quartz-scheduler.net/git
源码:https://github.com/quartznet/quartznetgithub
示例:http://www.quartz-scheduler.net/documentation/quartz-2.x/quick-start.html数据库
其实Quartz是一个彻底由java编写的开源做业调度框架,Quartz是OpenSymphony开源组织在Job scheduling领域又一个开源项目,它能够与J2EE与J2SE应用程序相结合也能够单独使用。Quartz能够用来建立简单或为运行十个,百个,甚至是好几万个Jobs这样复杂的程序。而Quartz.Net与NPOI同样是一个DoNet平台下的对应版本。若是您使用Java直接访问这里就行了http://www.quartz-scheduler.org/express
引入框架的方法很是简单你能够直接用nuget管理包,也能够在项目中添加引用,这里主要介绍前者。json
新版本的Visual Studio默认状况是安装了Nuget的,如Visual Studio2015,但若是没有安装,打开VS菜单“工具”->"扩展与更新"api
在扩展与更新中搜索“nuget”,能够新安装或卸载后升级:服务器
为解决国内访问NuGet服务器速度不稳定的问题建议你最好选择一些镜像服务器,这样能够加速下载。框架
在Visual Studio中的添加方法是:打开“工具”->“选项”菜单
在左侧菜单中找到“NuGet包管理器”
点击右上角的加号,添加两个镜像,这些地址能够上网搜索,我使用的是以下两个:
https://nuget.cnblogs.com/v3/index.json
http://api.nuget.org/v3/index.json
设置一下顺序就OK了。
点击“工具”->"NuGet包管理器"->“程序包管理器控制台”
输入安装包的命令:
Install-Package Quartz
安装结果以下:
此时包管理器中就下载了须要的程序集与相关文件,程序中也添加了引用。
定义一个类,实现Quartz.IJob接口,实现方法Execute,TimeJob.cs文件的代码以下:
1 using System; 2 using System.Threading.Tasks; 3 using Quartz; 4 using System.IO; 5 6 namespace QuartzDoNetDemo 7 { 8 /// <summary> 9 /// 文件记时任务 10 /// </summary> 11 public class TimeJob : IJob 12 { 13 /// <summary> 14 /// 文件记时任务 15 /// </summary> 16 /// <param name="context"></param> 17 /// <returns></returns> 18 Task IJob.Execute(IJobExecutionContext context) 19 { 20 21 //方式一 22 //Environment:提供有关当前环境和平台的信息以及操做它们的方法 23 //File.AppendAllText(@"d:\Quartz.txt", DateTime.Now + Environment.NewLine); 24 //return Task.Run(() => Console.WriteLine(DateTime.Now)); 25 26 //方式二 27 File.AppendAllText(@"d:\Quartz.txt", DateTime.Now + Environment.NewLine); 28 Console.WriteLine(DateTime.Now); 29 return Task.FromResult(true); 30 } 31 } 32 }
调度器负责管理与控制任务的执行:
1 //建立调度器工厂 2 ISchedulerFactory factory = new StdSchedulerFactory(); 3 4 //建立调度器 5 IScheduler scheduler = await factory.GetScheduler();
这个任务对象就是咱们将要执行的工做,job1是名称,group1是组名。
IJobDetail job = JobBuilder.Create<TimeJob>().WithIdentity("myJob1", "group1").Build();
触发器定义了什么时间任务开始或每隔多久执行一次.
1 //建立一个触发器:WithSimpleSchedule(a => a.WithIntervalInSeconds(10).RepeatForever()) 2 ITrigger trigger = TriggerBuilder.Create().WithIdentity("myTrigger1", "group1").StartNow().WithCronSchedule("0/10 * * * * ?").Build();
1 //将任务和触发器添加到调度器里 2 await scheduler.ScheduleJob(job, trigger); 3 4 //开始执行 5 await scheduler.Start();
cron表达式就是用于设定时间的一个字符串,在前面的代码中咱们就用到了,以下所示:
1 //建立一个触发器 2 ITrigger trigger = TriggerBuilder.Create() 3 .WithIdentity("myTrigger1", "group1") 4 .StartNow() 5 .WithCronSchedule("0/10 * * * * ?") //每10秒执行一次 6 .Build();
官方英文介绍:http://www.quartz-scheduler.net/documentation/quartz-2.x/tutorial/crontrigger.html
cron expressions 总体上仍是很是容易理解的,只有一点须要注意:"?"号的用法,看下文能够知道“?”能够用在 day of month 和 day of week中,他主要是为了解决以下场景,如:每个月的1号的每小时的31分钟,正确的表达式是:* 31 * 1 * ?,而不能是:* 31 * 1 * *,由于这样表明每周的任意一天。
/* 由7段构成:秒 分 时 日 月 星期 年(可选) "-" :表示范围 MON-WED表示星期一到星期三 "," :表示列举 MON,WEB表示星期一和星期三 "*" :表是“每”,每个月,天天,每周,每一年等 "/" :表示增量:0/15(处于分钟段里面) 每15分钟,在0分之后开始,3/20 每20分钟,从3分钟之后开始 "?" :只能出如今日,星期段里面,表示不指定具体的值 "L" :只能出如今日,星期段里面,是Last的缩写,一个月的最后一天,一个星期的最后一天(星期六) "W" :表示工做日,距离给定值最近的工做日 "#" :表示一个月的第几个星期几,例如:"6#3"表示每月的第三个星期五(1=SUN...6=FRI,7=SAT) 若是Minutes的数值是 '0/15' ,表示从0开始每15分钟执行 若是Minutes的数值是 '3/20' ,表示从3开始每20分钟执行,也就是‘3/23/43’ */
官方示例:
表达式 |
解释 |
0 0 12 * * ? |
天天中午12点触发 |
0 15 10 ? * * |
天天上午10:15触发 |
0 15 10 * * ? |
天天上午10:15触发 |
0 15 10 * * ? * |
天天上午10:15触发 |
0 15 10 * * ? 2005 |
2005年的天天上午10:15触发 |
0 * 14 * * ? |
在天天下午2点到下午2:59期间的每1分钟触发 |
0 0/5 14 * * ? |
在天天下午2点到下午2:55期间的每5分钟触发 |
0 0/5 14,18 * * ? |
在天天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发 |
0 0-5 14 * * ? |
在天天下午2点到下午2:05期间的每1分钟触发 |
0 10,44 14 ? 3 WED |
每一年三月的星期三的下午2:10和2:44触发 |
0 15 10 ? * MON-FRI |
周一至周五的上午10:15触发 |
0 15 10 15 * ? |
每个月15日上午10:15触发 |
0 15 10 L * ? |
每个月最后一日的上午10:15触发 |
0 15 10 L-2 * ? |
每月的次日到最后一天的上午10:15触发 |
0 15 10 ? * 6L |
每个月的最后一个星期五上午10:15触发 |
0 15 10 ? * 6L |
每月最后一个星期五上午10时15分触发 |
0 15 10 ? * 6L 2002-2005 |
2002年至2005年的每个月的最后一个星期五上午10:15触发 |
0 15 10 ? * 6#3 |
每个月的第三个星期五上午10:15触发 |
0 0 12 1/5 * ? |
每个月每隔5天下午12点(中午)触发, 从每个月的第一天开始 |
0 11 11 11 11 ? |
每11月11日上午11时11分触发 |
参考资料: