觸發(fā)器(Trigger)
Trigger是一個(gè)抽象類,Quartz提供了兩個(gè)比較常用的觸發(fā)器SimpleTrigger和CronTrigger。它們都是Trigger的子類
SimpleTrigger
這是一個(gè)簡(jiǎn)單的觸發(fā)器,通過(guò)它我們可以定義觸發(fā)的時(shí)間,并選擇性的設(shè)定重復(fù)的次數(shù)和間隔時(shí)間。它有以下常用的屬性
參數(shù)名 |
參數(shù)類型 |
備注 |
name |
String |
觸發(fā)器名稱 |
group |
String |
觸發(fā)器組名稱 |
repeatCount |
int |
重復(fù)次數(shù),注意:如果為0表示不執(zhí)行,-1表示不限制次數(shù)(直到過(guò)期),默認(rèn)為0 |
repeatInterval |
long |
間隔時(shí)間,注意:是以毫秒為單位 |
startTime |
Date |
開(kāi)始時(shí)間,默認(rèn)當(dāng)前時(shí)間 |
endTime |
Date |
過(guò)期時(shí)間,默認(rèn)一直執(zhí)行(直到執(zhí)行次數(shù)已達(dá)到repeatCount) |
CronTrigger
這個(gè)觸發(fā)器的功能非常強(qiáng)大,而且非常靈活,但需要掌握有關(guān)的Cron表達(dá)式知識(shí)
參數(shù)名 |
參數(shù)類型 |
備注 |
name |
String |
觸發(fā)器名稱 |
group |
String |
觸發(fā)器組名稱 |
cronEx |
CronExpression |
規(guī)則表達(dá)式 |
startTime |
Date |
開(kāi)始時(shí)間,默認(rèn)當(dāng)前時(shí)間 |
endTime |
Date |
過(guò)期時(shí)間,默認(rèn)一直執(zhí)行(直到執(zhí)行次數(shù)已達(dá)到repeatCount) |
觸發(fā)器規(guī)則表達(dá)式配置:
格式:
[秒] [分] [小時(shí)] [日] [月] [周] [年]
格式說(shuō)明:
位置 |
時(shí)間域名 |
是否必須 |
允許值 |
允許通配符 |
1 |
秒 |
是 |
0-59 |
, - * / |
2 |
分 |
是 |
0-59 |
, - * / |
3 |
小時(shí) |
是 |
0-23 |
, - * / |
4 |
日 |
是 |
1-31 |
, - * ? / L W |
5 |
月 |
是 |
1-12 |
, - * / |
6 |
周 |
是 |
1-7或MON-SUN |
, - * ? / L # |
7 |
年 |
否 |
empty或1970-2099 |
, - * / |
通配符說(shuō)明:
|
|
* |
可用在所有字段中,表示對(duì)應(yīng)時(shí)間域的每一個(gè)時(shí)刻,例如,*在分鐘字段時(shí),表示“每分鐘” |
? |
該字符只在日期和星期字段中使用,它通常指定為“無(wú)意義的值”,相當(dāng)于點(diǎn)位符 |
- |
表示區(qū)間。例如 在小時(shí)上設(shè)置 "10-12",表示 10,11,12點(diǎn)都會(huì)觸發(fā) |
, |
表示指定多個(gè)值,例如在周字段上設(shè)置 "MON,WED,FRI" 表示周一,周三和周五觸發(fā) |
/ |
x/y表達(dá)一個(gè)等步長(zhǎng)序列,x為起始值,y為增量步長(zhǎng)值。如在分鐘字段中使用0/15,則表示為0,15,30和45秒,而5/15在分鐘字段中表示5,20,35,50,你也可以使用*/y,它等同于0/y |
L |
該字符只在日期和星期字段中使用,代表“Last”的意思,但它在兩個(gè)字段中意思不同。L在日期字段中,表示這個(gè)月份的最后一天,如一月的31號(hào),非閏年二月的28號(hào);如果L用在星期中,則表示星期六,等同于7。但是,如果L出現(xiàn)在星期字段里,而且在前面有一個(gè)數(shù)值X,則表示“這個(gè)月的最后X天”,例如,6L表示該月的最后星期五 |
W |
該字符只能出現(xiàn)在日期字段里,是對(duì)前導(dǎo)日期的修飾,表示離該日期最近的工作日。例如15W表示離該月15號(hào)最近的工作日,如果該月15號(hào)是星期六,則匹配14號(hào)星期五;如果15日是星期日,則匹配16號(hào)星期一;如果15號(hào)是星期二,那結(jié)果就是15號(hào)星期二。但必須注意關(guān)聯(lián)的匹配日期不能夠跨月,如你指定1W,如果1號(hào)是星期六,結(jié)果匹配的是3號(hào)星期一,而非上個(gè)月最后的那天。W字符串只能指定單一日期,而不能指定日期范圍 |
# |
該字符只能在星期字段中使用,表示當(dāng)月某個(gè)工作日。如6#3表示當(dāng)月的第三個(gè)星期五(6表示星期五,#3表示當(dāng)前的第三個(gè)),而4#5表示當(dāng)月的第五個(gè)星期三,假設(shè)當(dāng)月沒(méi)有第五個(gè)星期三,忽略不觸發(fā) |