任务和触发器是quartz的两大块核心。触发器分CronTrigger 和SimpleTrigger。CronTrigger 支持比 SimpleTrigger 更具体的调度,而且也不是很复杂。基于 cron 表达式,CronTrigger支持类似日历的重复间隔,而不是单一的时间间隔如果你需要像日历那样按日程来触发任务,而不是像SimpleTrigger 那样每隔特定的间隔时间触发,CronTriggers通常比SimpleTrigger更有用。
使用CronTrigger,你可以指定诸如“每个周五中午”,或者“每个工作日的9:30”或者“从每个周一、周三、周五的上午9:00到上午 10:00之间每隔五分钟”这样日程安排来触发。甚至,象SimpleTrigger一样,CronTrigger也有一个StartTime以指定日程从什么时候开始,也有一个(可选的)EndTime以指定何时日程不再继续。
构造器
CronTrigger(String name, //触发器名称
String group, //触发器的组名
String jobName, //job名称
String jobGroup, //job的组名
Date startTime, //开始时间
Date endTime, //结束时间
String cronExpression, //克隆表达式
TimeZone timeZone)//时区
Cron Expressions——Cron 表达式
Cron表达式被用来配置CronTrigger实例。Cron表达式是一个由7个子表达式组成的字符串。每个子表达式都描述了一个单独的日程细节。这些子表达式用空格分隔。
Cron表达式格式:
字段名 |
必须有? |
值范围 |
允许的特殊字符 |
Seconds |
YES |
0-59 |
, - * / |
Minutes |
YES |
0-59 |
, - * / |
Hours |
YES |
0-23 |
, - * / |
Day of month |
YES |
1-31 |
, - * ? / L W C |
Month |
YES |
1-12 or JAN-DEC |
, - * / |
Day of week |
YES |
1-7 or SUN-SAT |
, - * ? / L C # |
Year |
NO |
empty, 1970-2099 |
, - * / |
所有的域中的值都有特定的合法范围,这些值的合法范围相当明显,例如:
1. 秒和分域的合法值为0到59,小时的合法范围是0到23。
2. Day-of-Month 中值得合法凡范围是0到31,但是需要注意不同的月份中的天数不同。
3. 月份的合法值是0到11。或者用字符串JAN,FEB MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV 及DEC来表示。
4. Days-of-Week可以用1到7来表示(1=星期日)或者用字符串SUN, MON, TUE, WED, THU, FRI 和SAT来表示.
特殊字符
也可以用“LW”来指定这个月的最后一个工作日。
在MONTH和Dayof week字段里对字母大小写不敏感。
下面是一些表达式以及它们的含义。
例1 – 一个简单的每隔5分钟触发一次的表达式
"0 0/5 * * * ?" CronTrigger
例2 – 在每分钟的10秒后每隔5分钟触发一次的表达式(例如. 10:00:10 am, 10:05:10等.)。
"10 0/5 * * * ?" CronTrigger
例3 – 在每个周三和周五的10:30,11:30,12:30触发的表达式。
"0 30 10-13 ? * WED,FRI" CronTrigger
例4 – 在每个月的5号,20号的8点和10点之间每隔半个小时触发一次且不包括10点,只是8:30,9:00和9:30的表达式。
"0 0/30 8-9 5,20 * ?"
例5 - "0 0 12 ? * WED",这表示“每周三的中午12:00”。
注意,对于单独触发器来说,有些日程需求可能过于复杂而不能用表达式表述,例如:9:00到10:00之间每隔5分钟触发一次,下午1:00到10点每隔 20分钟触发一次。这个解决方案就是创建两个触发器,两个触发器都运行相同的任务。