首页 > 代码库 > Quartz.net 2.x 学习笔记01
Quartz.net 2.x 学习笔记01
Quartz.net 2.0 2012年4月9日发布了Released版本，到目前（2014-12-08）为止是2.3版
Quartz.net 项目地址：http://www.quartz-scheduler.net/
官方2.x 教程：http://www.quartz-scheduler.net/documentation/quartz-2.x/tutorial/index.html
Quartz.net 2.x在.net中的使用
Quartz.net 的介绍和下载网上很多。Quartz.net是一个开源的专门用来处理我们日常所说的定时任务，就像你想让程序某些时间去做一些事情（例如：每天晚上0点的时候定时给领导发数据邮件）。
首先新建一个控制台应用程序：
第二步，添加Quartz.net的引用（有以下2种方式）
一、Quartz.net的引用可以自己下载dll自行引用（这里要提醒一下，quartz.net还依赖于Common.Logging.dll，同时版本要一致，下载可以去官方下载：http://www.quartz-scheduler.net/ 和Common.Logging连同一起）
二、直接使用NuGet添加引用
在搜索处输入quartz.net搜索安装即可(目前是2.3)
同上图可以看到它有个依赖项Common.Logging，安装时会自动将Common.Logging也安装上，所以推荐使用NuGet的引用方式。
当然NuGet你也可以通过命令的方式安装：Install-Package Quartz
开始之前先来说一下Quartz.net的配置(Configuration)
也有几种方式 （以下是自己的理解+翻译：http://www.quartz-scheduler.net/documentation/quartz-2.x/quick-start.html）
1、在你的程序中使用NameValueCollection的方式给定时器工厂(scheduler factory)提供参数
2、在程序的config文件中使用quartz配置节
3、在程序的根目录上使用一个命名为quartz.config的文件
三种方式其实是一样的，都是提供键值对的参数值 （方便以后修改的话，建议使用2或者3）
例如使用quartz.config 会看到是如下大概的形式：
quartz.scheduler.instanceName = MyScheduler quartz.threadPool.threadCount = 3 quartz.jobStore.type = Quartz.Simpl.RAMJobStore, Quartz |
上面简单的意思就是
定时器的名字是MyScheduler，线程池中分配3个线程，也就是说同时最多只能有3个任务在执行，第3个配置是任务的存储类型，因为默认Quartz的所有数据（JobDetail、triggers）是保存在内存中的，上面是配置存入数据库（可以去下载quartz.net的源码，你会看到它提供了相关的建表的语句，可以直接使用它的表，当然是靠配置去使用-------表有点多，并且我目前的业务没有那么复杂，如果使用，我会选择自己建表存储）。
第三步、下面开始一个简单的任务
我还是按照官方的教程一步一步来，将控制台的Program.cs修改成如下代码：
using System.Threading.Tasks;using Quartz;using Quartz.Impl;namespace Quartz001{ class Program { static void Main(string[] args) { //配置Common.Logging的日志输出为控制台的方式 Common.Logging.LogManager.Adapter = new Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter { Level = Common.Logging.LogLevel.Info }; try { //通过工厂得到Scheduler的一个实例 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler(); //开启 scheduler.Start(); Thread.Sleep(TimeSpan.FromSeconds(10)); //关闭定时器 scheduler.Shutdown(); Console.ReadKey(); } catch (SchedulerException ex) { Console.WriteLine(ex); } } }}
F5运行，输出
上面只是Quartz.net的最简单的开启和关闭
下面添加一个执行任务,Quartz的任务也很简单，只需要让任务类继承并实现IJob接口
右击控制台应用程序添加一个类HelloJob.cs
using Quartz;namespace Quartz001{ public class HelloJob:IJob { public void Execute(IJobExecutionContext context) { Console.WriteLine("我来自HelloJob任务"); } }}
然后对Program.cs代码做一些修改：
using System.Threading.Tasks;using Quartz;using Quartz.Impl;namespace Quartz001{ class Program { static void Main(string[] args) { //配置Common.Logging的日志输出为控制台的方式 Common.Logging.LogManager.Adapter = new Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter { Level = Common.Logging.LogLevel.Info }; try { //通过工厂得到Scheduler的一个实例 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler(); //开启 scheduler.Start(); //使用JobBuilder合建一个任务并和我们的HelloJob绑定在一起（注意Job的Key-相当于唯一标识） IJobDetail job = JobBuilder.Create<HelloJob>() .WithIdentity("job1", "group1") .Build(); //任务触发器--StartNow()立即执行，执行间隔10s,一直执行 ITrigger trigger = TriggerBuilder.Create() .WithIdentity("trigger1", "group1") .StartNow() .WithSimpleSchedule(x => x.WithIntervalInSeconds(10) .RepeatForever()) .Build(); //告诉Quartz用上面的触发器去定时执行job scheduler.ScheduleJob(job, trigger); Thread.Sleep(TimeSpan.FromSeconds(60)); //关闭定时器 scheduler.Shutdown(); } catch (SchedulerException ex) { Console.WriteLine(ex); } Console.WriteLine("按任意键退出！"); Console.ReadKey(); } }}
执行结果：
此时一个简单的定时任务就完成了
job任务里面，还可以通过JobDataMap往job中传递值
如新建一个DumbJob.cs任务
using Quartz;namespace Quartz001{ public class DumbJob:IJob { public void Execute(IJobExecutionContext context) { JobKey key = context.JobDetail.Key; JobDataMap dataMap = context.JobDetail.JobDataMap; string jobSays = dataMap.GetString("jobSays"); float myFloatValue = http://www.mamicode.com/dataMap.GetFloat("myFloatValue"); Console.Error.WriteLine("DumbJob的任务实例说：" + jobSays + "值是：" + myFloatValue); } }}
修改Program.cs文件代码
using System.Threading.Tasks;using Quartz;using Quartz.Impl;namespace Quartz001{ class Program { static void Main(string[] args) { //配置Common.Logging的日志输出为控制台的方式 Common.Logging.LogManager.Adapter = new Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter { Level = Common.Logging.LogLevel.Info }; try { //通过工厂得到Scheduler的一个实例 IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler(); //开启 scheduler.Start(); //使用JobBuilder合建一个任务并和我们的HelloJob绑定在一起（注意Job的Key-相当于唯一标识） IJobDetail job = JobBuilder.Create<HelloJob>() .WithIdentity("job1", "group1") .Build(); //任务触发器--StartNow()立即执行，执行间隔10s,一直执行 ITrigger trigger = TriggerBuilder.Create() .WithIdentity("trigger1", "group1") .StartNow() .WithSimpleSchedule(x => x.WithIntervalInSeconds(10) .RepeatForever()) .Build(); IJobDetail dumbJob = JobBuilder.Create<DumbJob>() .WithIdentity("myJob", "dumbGroup") .UsingJobData("jobSays", "我是DumbJob，大家好！") .UsingJobData("myFloatValue", 3.141f) .Build(); //还可以使用下面的方式传递数据 //JobDataMap map = jobDetail.JobDataMap; //map.Put("jobSays", "我是DumbJob，大家好！"); ITrigger dumbTrigger = TriggerBuilder.Create() .StartNow() .WithSimpleSchedule(x=>x.WithIntervalInSeconds(3).WithRepeatCount(3)) //3秒钟执行一次，执行3次（加上启动的一次，输出会有4次） .Build(); //告诉Quartz用上面的触发器去定时执行job scheduler.ScheduleJob(job, trigger); scheduler.ScheduleJob(dumbJob, dumbTrigger); Thread.Sleep(TimeSpan.FromSeconds(60)); //关闭定时器 scheduler.Shutdown(); } catch (SchedulerException ex) { Console.WriteLine(ex); } Console.WriteLine("按任意键退出！"); Console.ReadKey(); } }}
输出结果：
源码下载
学习参阅资料：
http://www.cnblogs.com/lzrabbit/archive/2012/04/13/2447609.html
http://www.cnblogs.com/Raymond-YYC/p/3975378.html
http://www.cnblogs.com/monian/p/3822980.html
http://geekswithblogs.net/TarunArora/archive/2013/01/20/quartz.net-scheduler-exposed-via-a-web-service.aspx
Quartz.net 2.x 学习笔记01