作业调度框架 Quartz.NET 2.0 入门(Quartz2.0 C#)

和帅书馆 2015-10-15

展开全文

注：目前网上诸多介绍Quartz.net的文章，甚至Quartz.net官网上的Tutorial都是1.0版本的，而这个项目在2.0版本对项目进行了比较大规模的修改，使得原有的很多例子都不能运行，故写此文。由于本人是边学边用，加之技术写作水平皆有限，错误自然难免，望轻拍，我将不定时更新完善此贴，希望能为需要的朋友提供帮助。

1. 项目介绍

现今的系统，业务数据是越来越大，传统的同步处理方式有时候已经不能满足用户需求，定时后台服务这种异步数据处理形式则逐渐被大家接受。相信大家在平时的工作中也经常遇到数据同步，或是定时邮件，短信提醒等需求，Quartz.net（官网 http://quartznet./）可以很好满足对多个windows服务的管理及监控，同时在保证开发简单的情况下不失灵活，是非常优秀的作业调度框架。

和其他绝大多数开源项目一样Quartz.net也包含了其他几个优秀的开源项目:

核心 ----Common.Logging（通用日志接口）

----C5（泛型集合类）

示例程序

----log4net（日志记录-通用日志接口实现）

----topshelf（跨平台服务宿主程序）

Quartz.net使用的许可是Apache License，商业友好，使用者可以修改源码用于开源或商业项目，只需包含许可及修改说明。

2. Quartz.net开发思路

我们来了解下Quartz.net中常用的几个概念：

Scheduler ---------主调度程序 --------- Quartz核心

Job ---------作业 --------- 服务要做的（业务操作）

Trigger ---------触发器 --------- 服务执行条件（何时执行操作）

Listener ---------事件监听器 --------- 执行期事件（Job执行前后/ Scheduler启动终止暂停时应该做什么，可以挂一些特定事件）

了解了这些概念之后，我们就可以组合这些概念并整理出开发的思路：

先利用SchedulerFactory构建一个Scheduler，启动Scheduler，之后构建Job和Trigger，若有作业监听需求，在Listener上添加相应的处理程序，再将Job和Trigger关联后放入Scheduler

3. Quartz.net的简单使用

1. 新建一个控制台程序，引用Quartz.dll和Common.Logging.dll

2. 新建一个类，命名为SampleJob，继承并实现接口Quartz.IJob

			
public class SampleJob : IJob
    {
        public void Execute(IJobExecutionContext context)
        {
            File.AppendAllText("C:\\Quartz.txt", "SampleJob Is Run");
            File.AppendAllText("C:\\Quartz.txt", Environment.NewLine);  
        }
    }
			

3.在Program.cs的main方法中写如下代码后运行这个控制台会程序会发现已经SampleJob中的Execute方法已经执行

		  ISchedulerFactory  factory = new StdSchedulerFactory();
            IScheduler scheduler = factory.GetScheduler();
            scheduler.Start();
            IJobDetail job = JobBuilder.Create<SampleJob>().WithIdentity("SampleJob", "JobGroup1").Build();
            ITrigger trigger = TriggerBuilder.Create().StartNow().Build();
            scheduler.ScheduleJob(job, trigger);
	

4. 使用topshelf创建WINDOWS服务

注：此部分张善友同学已经写过（http://www.cnblogs.com/shanyou/archive/2011/05/04/2037008.html）,此节为保证思路连贯，简单介绍并引用部分代码

也许有的网友会疑问，以控制台程序作为服务宿主还没有意义的，这时轮到Topshelf出场了，使用它可以很方便的构建跨平台服务寄主，而在调试时直接以控制台的形式运行即可，非常方便。我们引入topshelf.dll及 log4net.dll(topshelf需要),将之前main中代码放到服务类里，把main方法变为Host构建

服务类代码:

			
  public class SampleService
    {
        ISchedulerFactory factory;
        IScheduler scheduler;
        public void Start()
        {
            File.AppendAllText("C:\\Quartz.txt", "SampleService Is Run");
            File.AppendAllText("C:\\Quartz.txt", Environment.NewLine);
            factory = new StdSchedulerFactory();
            scheduler = factory.GetScheduler();
            scheduler.Start();
            IJobDetail job = JobBuilder.Create<SampleJob>().WithIdentity("SampleJob", "JobGroup1").Build();
            ITrigger trigger = TriggerBuilder.Create().StartNow().Build();          
            scheduler.ScheduleJob(job, trigger);
        }
        public void Stop()
        {
            scheduler.Clear();
            File.AppendAllText("C:\\Quartz.txt", "SampleService Is Stop");
            File.AppendAllText("C:\\Quartz.txt", Environment.NewLine);
        }
    }
			

修改后的Main代码

			
        static void Main(string[] args)
        {
            var host = HostFactory.New(x =>
            {
                x.EnableDashboard(); x.Service<SampleService>(s =>
{
    s.SetServiceName("SampleService"); s.ConstructUsing(name => new SampleService());
    s.WhenStarted(tc => { tc.Start(); });
    s.WhenStopped(tc => tc.Stop());
});
                x.RunAsLocalSystem();
                x.SetDescription("SampleService Description");
                x.SetDisplayName("SampleService");
                x.SetServiceName("SampleService");
            });
            host.Run();

        }
			