Quartz.NET学习笔记(一) 简介
Quartz.NET是一款开源的任务调度框架,他是由Java中的任务调度框架Quartz移植而来的。官方网站https://www.quartz-scheduler.net/。
Quartz.Net的特性
运行环境
- Quartz.NET可以寄宿在其他的.NET程序中运行
- Quartz.NET可以作为独立程序运行
- Quartz.NET可以在集群中使用,支持负载均衡和故障切换
任务调度
- 任务和触发器是多对一关系, 同一个任务可以绑定到多个触发器中,但是一个触发器只能绑定一个任务
- 触发器可以在某天特定时间触发
- 触发器可以在一周某一天触发(周一-周日)
- 触发器可以在一个月中某一天触发
- 触发器可以在一年某一天触发
- 触发器支持排除日期列表
- 触发器支持指定次数的重复触发
- 触发器支持无限次数的重复触发
- 触发器支持直到某个时间/日期重复触发
- 触发器支持一定时间间隔的重复触发
任务执行
- 所有的任务类都必须实现IJob接口
- 所有的定义的任务类都可以由NET实例化
- 当触发器触发,调度器会根据当前任务的状态通知所有JobListener和TriggerListener
- 当任务完成时,系统会返回一个任务完成码来通知调度器任务成功还是失败,调度器可以根据任务完成码做出不同的反应。
任务持久化
- 支持使用NET进行任务持久化
- 支持使用内存进行任务持久化
- 自定义持久化(实现IJobStore接口)
简单例子
首先我们先用一个简单例子,对Quartz.NET有一个大概的了解。
创建项目
打开Visual Studio, 创建一个简单的控制台程序
添加Quartz.NET库
我们可以从官网下载最新的Quartz.NET的库,但是使用Nuget来管理.NET库更便捷。
打开Package Manager Console,输入
install-package Quartz
添加第一个任务
添加一个新类FirstJob.cs, 其代码如下。
public class FirstJob : IJob { public void Execute(IJobExecutionContext context) { Console.WriteLine("Hello World."); } }
所有的任务都必须实现IJob接口, IJob接口中只包含一个需要实现的方法Execute, 该方法中加入的代码,即这个任务需要干的事情。
创建调度器
在Program.cs的Main方法中加入以下代码
ISchedulerFactory schedFact = new StdSchedulerFactory(); IScheduler sched = schedFact.GetScheduler(); sched.Start();
这里使用的是抽象工厂模式, 使用默认的调度器工厂StdSchedulerFactory来创建一个调度器。所有的调度器都需要手动调用Start()方法来启动。
创建任务和触发器
在Main方法中继续添加以下代码
IJobDetail job = JobBuilder.Create<FirstJob>() .WithIdentity("myJob", "group1") .Build(); ITrigger trigger = TriggerBuilder.Create() .WithIdentity("myTrigger", "group1") .StartNow() .Build();
这里JobBuilder负责根据指定的任务类型产生一个任务项,并绑定任务需要的参数或者为任务进行分组。
TriggerBuilder负责产生不用类型的触发器,前面特性里面有说明,触发器有很多类型,都是在这里设置的,并且在这里可以对触发器进行分组。这里StartNow()表示触发器加入调度器后,立即执行。
使用调度器,绑定触发器和任务
前面我们只是创建了任务和触发器,他们之间现在还没有任何关联。
下面我们在Main方法中加入最后一行代码
sched.ScheduleJob(job, trigger);
调度器将触发器和任务绑定在一起。
最终实现效果
启动项目,效果如下, Hello World正确显示了