介绍
前面介绍Quartz.Net的基本用法，但在实际应用中，往往有更多的特性需求，比如记录job执行的执行历史，发邮件等。
阅读目录
- Quartz.Net插件
- TriggerListener,JobListener
- Cron表达式
- Quartz.Net线程池
- 总结
Quartz.Net插件
Quartz.net 自身提供了一个插件接口(ISchedulerPlugin)用来增加附加功能，看下官方定义：
1
2
3
4
5
6
7
8
public interface ISchedulerPlugin
{
void Initialize(``string pluginName, IScheduler sched);
void Shutdown();
void Start();
}
继承接口，实现自己的插件。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public class MyPlugin : ISchedulerPlugin
{
public void Initialize(``string pluginName, IScheduler sched)
{
Console.WriteLine(``"实例化"``);
}
public void Start()
{
Console.WriteLine(``"启动"``);
}
public void Shutdown()
{
Console.WriteLine(``"关闭"``);
}
}
主函数里面配置要实现的插件，注释部分，一句话搞定。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
static void Main(``string``[] args)
{
var properties = new NameValueCollection();
properties[``"quartz.plugin.MyPlugin.type"``] = "QuartzDemo3.MyPlugin,QuartzDemo3"``;
var schedulerFactory = new StdSchedulerFactory(properties);
var scheduler = schedulerFactory.GetScheduler();
var job = JobBuilder.Create<HelloJob>()
.WithIdentity(``"myJob"``, "group1"``)
.Build();
var trigger = TriggerBuilder.Create()
.WithIdentity(``"mytrigger"``, "group1"``)
.WithCronSchedule(``"/2 * * ? * *"``)
.Build();
scheduler.ScheduleJob(job, trigger);
scheduler.Start();
Thread.Sleep(6000);
scheduler.Shutdown(``true``);
Console.ReadLine();
}
运行结果如下：
— Quartz.Net进阶/172151135196757.png)
TriggerListener，JobListener
这2个是对触发器和job本身的行为监听器，这样更好方便跟踪Job的状态及运行情况。
ITriggerListener是官方定义的接口，这里我们直接继承实现。
public class MyTriggerListener : ITriggerListener
{ private string name; public void TriggerComplete(ITrigger trigger, IJobExecutionContext context, SchedulerInstruction triggerInstructionCode)
{
Console.WriteLine(“job完成时调用”);
} public void TriggerFired(ITrigger trigger, IJobExecutionContext context)
{
Console.WriteLine(“job执行时调用”);
} public void TriggerMisfired(ITrigger trigger)
{
Console.WriteLine(“错过触发时调用(例：线程不够用的情况下)”);
} public bool VetoJobExecution(ITrigger trigger, IJobExecutionContext context)
{ //Trigger触发后，job执行时调用本方法。true即否决，job后面不执行。
return false;
} public string Name { get { return name; } set { name = value; } }
}
主函数添加：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
scheduler.ListenerManager.AddTriggerListener(myJobListener, KeyMatcher<TriggerKey>.KeyEquals(``new TriggerKey(``"mytrigger"``, "group1"``)));
////添加监听器到指定分类的所有监听器。
////添加监听器到指定分类的所有监听器。
////添加监听器到指定的2个分组。
////添加监听器到所有的触发器上。
scheduler.Start();
JobListener同理，这里不多做描述。
Cron表达式
quartz中的cron表达式和Linux下的很类似，比如 “/5 * * ? * * *“ 这样的7位表达式，最后一位年非必选。
表达式从左到右，依此是秒、分、时、月第几天、月、周几、年。下面表格是要遵守的规范：
字段名
允许的值
允许的特殊字符
Seconds
0-59
, - * /
Minutes
0-59
, - * /
Hours
0-23
, - * /
Day of month
1-31
, - * ? / L W
Month
1-12 or JAN-DEC
, - * /
Day of week
1-7 or SUN-SAT
, - * ? / L #
Year
空, 1970-2099
, - * /
特殊字符
解释
,
或的意思。例：分钟位 5,10 即第5分钟或10分都触发。
/
a/b。 a：代表起始时间，b频率时间。 例； 分钟位 3/5， 从第三分钟开始，每5分钟执行一次。
*
频率。 即每一次波动。 例；分钟位 * 即表示每分钟
-
区间。 例： 分钟位 5-10 即5到10分期间。
?
任意值 。 即每一次波动。只能用在DayofMonth和DayofWeek，二者冲突。指定一个另一个一个要用?
L
表示最后。 只能用在DayofMonth和DayofWeek，4L即最后一个星期三
W
工作日。 表示最后。 只能用在DayofWeek
4#2。 只能用DayofMonth。 某月的第二个星期三
实例介绍
”0 0 10,14,16 * * ?” 每天10点，14点，16点 触发。
“0 0/5 14,18 * * ?” 每天14点或18点中，每5分钟触发 。
“0 4/15 14-18 * * ?” 每天14点到18点期间, 从第四分钟触发，每15分钟一次。
“0 15 10 ? * 6L” 每月的最后一个星期五上午10:15触发。
Quartz.Net线程池
线程池数量设置：
properties[“quartz.threadPool.threadCount”] = “5”;
这个线程池的设置，是指同时间，调度器能执行Job的最大数量。
quartz是用每个线程跑一个job。上面的设置可以解释是job并发时能执行5个job，剩下的job如果触发时间恰好到了，当前job会进入暂停状态，直到有可用的线程。
如果在指定的时间范围依旧没有可用线程，会触发misfired时间。
quartz 提供了IThreadPool接口，也可以用自定义线程池来实现。
配置如下：
properties[“quartz.threadPool.type”] = “Quartz.Simpl.SimpleThreadPool, Quartz”;
一般来说作业调度很少并发触发大量job，如果有上百个JOB，可在服务器承受范围内适量增加线程数量。
总结
官方有LoggingTriggerHistoryPlugin，LoggingJobHistoryPlugin 已实现的，触发器和job历史记录的插件。
Quartz.Plugin 命名空间下有官方实现的其他一些插件，也可以自己增加扩展。
quartz中监听器还有SchedulerListener，使用方法基本一样。
本文基于自用经验和官方文档代码来写的，部分是直接翻译的。
Quartz.Net官方教程http://www.quartz-scheduler.net/documentation/quartz-2.x/tutorial/index.html
