Quartz.NET 架构与源代码分析系列 part 3 ：Trigger 触发器

      在上一篇《Quartz.NET 架构与源代码分析系列 part 2 ：Job 作业》我们分析了Quartz.NET 的 IJob 继承结构以及Quartz.NET 附带的几个 Job类。现在，我们要介绍 Job 执行的条件，也就是 Trigger 触发器。

Trigger 抽象类

      Quartz.NET 有一个 Trigger 抽象类，它有一些重要的方法和参数，已经标在图1 上。

图1 Trigger 抽象类图

      从图2 可以看出，Quartz.NET 实现了3个具体的触发器类，SimpleTrigger 简单地在某一时间重复执行多少次，NthIncludedDayTrigger 在每一年、月、周的第几天(Nth)执行作业，CronTrigger 使用 Unix 平台下的'cron-like’表达式来实现非常灵活的触发时间。

图2 Trigger 继承结构

SimpleTrigger

       我们来看一下SimpleTrigger 的构造函数：

/// <param name="name">触发器名</param>
/// <param name="group">触发器组名</param>
/// <param name="jobName">绑定的任务名</param>
/// <param name="jobGroup">绑定的任务组名</param>
/// <param name="startTimeUtc">开始执行时间A <see cref="DateTime" /> set to the time for the <see cref="Trigger" />
/// to fire.</param>
/// <param name="endTimeUtc">结束执行时间A <see cref="DateTime" /> set to the time for the <see cref="Trigger" />
/// to quit repeat firing.</param>
/// <param name="repeatCount">重复触发次数The number of times for the <see cref="Trigger" /> to repeat
/// firing, use RepeatIndefinitely for unlimited times.</param>
/// <param name="repeatInterval">触发间隔The time span to pause between the repeat firing.</param>
public SimpleTrigger(string name, string group, string jobName, string jobGroup, DateTime startTimeUtc,
         NullableDateTime endTimeUtc,
         int repeatCount, TimeSpan repeatInterval)
    : base(name, group, jobName, jobGroup)
{
    StartTimeUtc = startTimeUtc;
    EndTimeUtc = endTimeUtc;
    RepeatCount = repeatCount;
    RepeatInterval = repeatInterval;
}

      它有一个起始时间和结束时间，起始时间触发器触发，过了结束时间触发器停止触发。时间间隔 Interval，触发次数 RepeatCount。

图3 SimpleTrigger 触发器工作示例图

CronTrigger

       CronTrigger 使用 UNIX 下的“Cron-like” 表达式，实际上用起来感觉它很像正则表达式，可以匹配任意时间，这是体现它灵活性的地方。它的规则如下：

Cron 表达式包括以下 7 个字段（1 个可选）

秒  分 小时 月内日期 月 周内日期 年（可选）

表达式的每个数值域都是一个有最大值和最小值的集合，如：秒域和分钟域的集合是0-59，日期域是1-31，月份域是1-12。注意：秒、分、小时字段是从小到大排序的，这是西方人的习惯，所以在使用的时候要小心，不要颠倒过来。

允许值及对应表见表1。

表1. Cron 表达式允许值及对应表

字段	允许值	允许的特殊字符
秒	0-59	, - * /
分	0-59	, - * /
小时	0-23	, - * /
月内日期	1-31	, - * ? / L W C
月	1-12 或者 JAN-DEC	, - * /
周内日期	1-7 或者 SUN-SAT	, - * ? / L C #
年（可选）	留空, 1970-2099	, - * /

特殊字符意义对应表见表2。

表2. Cron 表达式特殊字符意义对应表

特殊字符	意义
*	匹配所有的值。如：*在分钟的字段域里表示 每分钟
?	只在日期域和星期域中使用。它被用来指定“非明确的值”
-	指定一个范围。如：“10-12”在小时域意味着“10点、11点、12点”
,	指定几个可选值。如：“MON,WED,FRI”在星期域里表示“星期一、星期三、星期五”
/	指定增量。如：“0/15”在秒域意思是没分钟的0，15，30和45秒。“5/15”在分钟域表示没小时的5，20，35和50。符号“*”在“/”前面（如：*/10）等价于0在“/”前面（如：0/10）
L	表示day-of-month和day-of-week域，但在两个字段中的意思不同，例如day-of-month域中表示一个月的最后一天。如果在day-of-week域表示‘7’或者‘SAT’，如果在day-of-week域中前面加上数字，它表示一个月的最后几天，例如‘6L’就表示一个月的最后一个星期五
W	只允许日期域出现。这个字符用于指定日期的最近工作日。例如：如果你在日期域中写 “15W”，表示：这个月15号最近的工作日。所以，如果15号是周六，则任务会在14号触发。如果15好是周日，则任务会在周一也就是16号触发。如果是在日期域填写“1W”即使1号是周六，那么任务也只会在下周一，也就是3号触发，“W”字符指定的最近工作日是不能够跨月份的。字符“W”只能配合一个单独的数值使用，不能够是一个数字段，如：1-15W是错误的
LW	L和W可以在日期域中联合使用，LW表示这个月最后一周的工作日
#	只允许在星期域中出现。这个字符用于指定本月的某某天。例如：“6#3”表示本月第三周的星期五（6表示星期五，3表示第三周）。“2#1”表示本月第一周的星期一。“4#5”表示第五周的星期三
C	允许在日期域和星期域出现。这个字符依靠一个指定的“日历”。也就是说这个表达式的值依赖于相关的“日历”的计算结果，如果没有“日历”关联，则等价于所有包含的“日历”。如：日期域是“5C”表示关联“日历”中第一天，或者这个月开始的第一天的后5天。星期域是“1C”表示关联“日历”中第一天，或者星期的第一天的后1天，也就是周日的后一天（周一）

示例：

"0 0 0 1 1 ?”               每年元旦1月1日 0 点触发

"0 15 10 * * ? *"         每天上午10:15触发 
"0 15 10 * * ? 2005"   2005年的每天上午10:15触发

"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 ? * 6#3"        每月的第三个星期五上午10:15触发

 

应用示例

      下面是用SimpleTrigger 和 CronTrigger 实现的触发配置面板：

 

代码下载：QuartzExampleWin32_Source.rar

下一篇，我们将要介绍：Schedule 调度器

参考文章

1.The Official Quartz.NET Tutorial

2.Quartz的cron表达式

 

目录：   Quartz.NET 架构与源代码分析系列

上一篇：Quartz.NET 架构与源代码分析系列 part 2 ：Job 作业

下一篇：Quartz.NET 架构与源代码分析系列 part 4  ：Schedule 调度器