比較常用的兩種job區別
1.一個類實現了 org.quartz.Job 接口,默認方法 execute()
execute()參數 JobExecutionContext 被用來訪問 org.quartz.JobDetail 類, JobDetail 類持有 Job 的詳細信息
2.一個類實現了 org.quartz.StatefulJob 得到是一個同一個描述,但任務還是新的任務。( JobDetail 不會改變)
注:Scheduler 會為每一次執行創建新的 Job 實例
package org.ymm.chapter3; import org.quartz.Job; import org.quartz.JobDataMap; import org.quartz.JobDetail; import org.quartz.JobExecutionContext; import org.quartz.JobExecutionException; public class DirectoryJob implements Job{ @Override public void execute(JobExecutionContext context) throws JobExecutionException { // TODO Auto-generated method stub JobDetail jobDetail = context.getJobDetail(); JobDataMap jdm=jobDetail.getJobDataMap(); String uName=jdm.getString("uname"); System.out.println(uName+" say hello1..."+"Job Class: " + jobDetail.getJobClass()); } }
3.創建一個 Scheduler 調度器管理job,從工廠中很方便得到
QuartZTest qt=new QuartZTest(); try { /*Scheduler sch =StdSchedulerFactory.getDefaultScheduler();*/ DirectSchedulerFactory factory=DirectSchedulerFactory.getInstance(); factory.createVolatileScheduler(5);//告訴工廠以5個工作者線程初始化它自己 Scheduler sch= factory.getScheduler(); sch.start(); //qt.schJob(sch,"DirectoryJob",DirectoryJob.class,"yy",2);//關聯job } catch (SchedulerException e) { e.printStackTrace(); }
4 .創建一個 JobDetail 的描述和 trigger 觸發器
public void schJob(Scheduler sch,String jobName,Class jobclass,String name,Integer scanInterval) throws SchedulerException{ JobDetail jobDetail=new JobDetail(jobName,Scheduler.DEFAULT_GROUP,jobclass); jobDetail.getJobDataMap().put("uname", name); Trigger trigger=TriggerUtils.makeSecondlyTrigger(scanInterval); trigger.setName("DirectoryJob" + "-Trigger"); trigger.setStartTime(new Date()); //得到當前時間 Calendar nTime = Calendar.getInstance(); nTime.add(Calendar.MINUTE, 1); trigger.setEndTime(nTime.getTime()); // trigger.setEndTime(new Date(new Date().getTime() + 30000)); sch.scheduleJob(jobDetail, trigger); }
NthIncludedDayTrigger nt = new NthIncludedDayTrigger(jd.getName()+"-Trigger",Scheduler.DEFAULT_FAIL_OVER_GROUP); // nt.setName(jd.getName()+"-Trigger"); nt.setIntervalType(NthIncludedDayTrigger.INTERVAL_TYPE_WEEKLY); nt.setN(Calendar.MONDAY); //每個月第三天 // nt.setIntervalType(NthIncludedDayTrigger.INTERVAL_TYPE_MONTHLY); // nt.setN(3); nt.setFireAtTime("12:00:00"); nt.setStartTime(new Date());//注意,有效時間是從這個啟動時間開始算的
顧名思義,Trigger 的責任就是觸發一個 Job 去執行。當用 Scheduler 注冊一個 Job 的時候要創建一個 Trigger 與這個 Job 相關聯。Quartz 提供了四種類型的 Trigger,但其中兩種是最為常用的,它們就是要用到的 SimpleTrigger 和 CronTrigger.
(上面的NthIncludedDayTrigger主要對日期)
SimpleTrigger 是兩個之中簡單的那個,它主要用來激發單事件的 Job,Trigger 在指定時間激發,并重復 n 次--兩次激發時間之間的延時為 m,然后結束作業。CronTrigger 非常復雜且強大。它是基于通用的公歷,當需要用一種較復雜的時間表去執行一個 Job 時用到。例如,四月至九月的每個星期一、星期三、或星期五的午夜。
為更簡單的使用 Trigger,Quartz 包含了一個工具類,叫做 org.quartz.TriggerUtils. TriggerUtils 提供了許多便捷的方法簡化了構造和配置 trigger. 上面用的就是 TriggerUtils 類;
調用了 TriggerUtils 的方法 makeSecondlyTrigger() 來創建一個每2秒種激發一次的 trigger(實際是由 TriggerUtils 生成了一個 SimpleTrigger 實例,但是我們的代碼并不想知道這些)。我們同樣要給這個 trigger 實例一個名稱并告訴它何時激發相應的 Job;與之關聯的 Job 會立即啟動,因為由方法 setStartTime() 設定的是當前時間。
CronTrigger :
public void schJob(Scheduler sch,String jobName,Class jobclass,String name,Integer scanInterval) throws SchedulerException{ JobDetail jobDetail=new JobDetail(jobName,Scheduler.DEFAULT_GROUP,jobclass); jobDetail.getJobDataMap().put("uname", name); CronTrigger trigger=null; try { trigger = new CronTrigger("CronTrigger",null,"1 * * ? * *"); } catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); } /*Trigger trigger=TriggerUtils.makeSecondlyTrigger(scanInterval); trigger.setName("DirectoryJob" + "-Trigger"); trigger.setStartTime(new Date()); //得到當前時間 Calendar nTime = Calendar.getInstance(); nTime.add(Calendar.MINUTE, 1); trigger.setEndTime(nTime.getTime()); //trigger.setEndTime(new Date(new Date().getTime() + 30000)); */ sch.scheduleJob(jobDetail, trigger); }
表 5.1. Quartz Cron 表達式支持到七個域
名稱 | 是否必須 | 允許值 | 特殊字符 |
秒 | 是 | 0-59 | , - * / |
分 | 是 | 0-59 | , - * / |
時 | 是 | 0-23 | , - * / |
日 | 是 | 1-31 | , - * ? / L W C |
月 | 是 | 1-12 或 JAN-DEC | , - * / |
周 | 是 | 1-7 或 SUN-SAT | , - * ? / L C # |
年 | 否 | 空 或 1970-2099 | , - * / |
使用星號(*) 指示著你想在這個域上包含所有合法的值。例如,在月份域上使用星號意味著每個月都會觸發這個 trigger。
表達式樣例:
0 * 17 * * ?
意義:每天從下午5點到下午5:59中的每分鐘激發一次 trigger。它停在下午 5:59 是因為值 17 在小時域上,在下午 6 點時,小時變為 18 了,也就不再理會這個 trigger,直到下一天的下午5點。
在你希望 trigger 在該域的所有有效值上被激發時使用 * 字符。
? 問號
? 號只能用在 日 和 周域 上,但是不能在這兩個域上同時使用。你可以認為 ? 字符是 "我并不關心在該域上是什么值。" 這不同于星號,星號是指示著該域上的每一個值。? 是說不為該域指定值。
不能同時這兩個域上指定值的理由是難以解釋甚至是難以理解的。基本上,假定同時指定值的話,意義就會變得含混不清了:考慮一下,如果一個表達式在 日 域上有值11,同時在 周 域上指定了 WED 。那么是要 trigger 僅在每個月的11號,且正好又是星期三那天被激發?還是在每個星期三的11號被激發呢?要去除這種不明確性的辦法就是不能同時在這兩個域上指定值。
只要記住,假如你為這兩域的其中一個指定了值,那就必須在另一個字值上放一個 ? 。
表達式樣例:
0 10,44 14 ? 3 WEB
意義:在三月中的每個星期三的下午 2:10 和 下午 2:44 被觸發。
, 逗號
逗號 ( , ) 是用來在給某個域上指定一個值列表的。例如,使用值 0,15,30,45 在秒域上意味著每15秒觸發一個 trigger。
表達式樣例:
0 0,15,30,45 * * * ?
意義:每刻鐘觸發一次 trigger。
/ 斜杠
斜杠 ( / ) 是用于時間表的遞增的。我們剛剛用了逗號來表示每15分鐘的遞增,但是我們也能寫成這樣 0/15 。
表達式樣例:
0/15 0/30 * * * ?
意義:在整點和半點時每15秒觸發 trigger。
- 中劃線
中劃線 ( - ) 用于指定一個范圍。例如,在小時域上的 3-8 意味著 "3,4,5,6,7 和 8 點。" 域的值不允許回卷,所以像 50-10 這樣的值是不允許的。
表達式樣例:
0 45 3-8 ? * *
意義:在上午的3點至上午的8點的45分時觸發 trigger。
L 字母
L 說明了某域上允許的最后一個值。它僅被 日 和 周 域支持。當用在日域上,表示的是在 月 域上指定的月份的最后一天。例如,當月域上指定了 JAN 時,在 日 域上的 L 會促使 trigger 在1月31號被觸發。假如 月 域上是 SEP ,那么 L 會預示著在9月30號觸發。換句話說,就是不管指定了哪個月,都是在相應月份的時最后一天觸發 trigger。
表達式 0 0 8 L * ? 意義是在每個月最后一天的上午 8:00 觸發 trigger。在 月 域上的 * 說明是 "每個月"。
當 L 字母用于周域上,指示著周的最后一天,就是星期六 (或者數字7)。所以如果你需要在每個月的最后一個星期六下午的 11:59 觸發 trigger,你可以用這樣的表達式 0 59 23 ? * L 。
當使用于 周 域上,你可以用一個數字與 L 連起來表示月份的最后一個星期 X。例如,表達式 0 0 12 ? * 2L 說的是在每個月的最后一個星期一觸發 trigger。
不要讓范圍和列表值與 L 連用
雖然你能用星期數( 1-7 )與 L 連用,但是不允許你用一個范圍值和列表值與 L 連用。這會產生不可預知的結果。 |
W 字母
W 字符代表著平日 ( Mon-Fri ),并且僅能用于日域中。它用來指定離指定日的最近的一個平日。大部分的商業處理都是基于工作周的,所以 W 字符可能是非常重要的。例如,日域中的 15W 意味著 "離該月15號的最近一個平日。" 假如15號是星期六,那么 trigger 會在14號(星期四)觸發,因為距15號最近的是星期一,這個例子中也會是17號 (譯者Unmi注:不會在17號觸發的,如果是 15W ,可能會是在14號(15號是星期六)或者15號(15號是星期天)觸發,也就是只能出現在鄰近的一天,如果15號當天為平日直接就會當日執行) 。 W 只能用在指定的 日 域為單天,不能是范圍或列表值。
# 井號
# 字符僅能用于 周 域中。它用于指定月份中的第幾周的哪一天。例如,如果你指定周域的值為 6#3 ,它意思是某月的第三個周五 ( 6 =星期五, #3 意味著月份中的第三周)。另一個例子 2#1 意思是某月的第一個星期一 ( 2 =星期一, #1 意味著月份中的第一周)。注意,假如你指定 #5 ,然而月份中沒有第 5 周,那么該月不會觸發。
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索:z360901061

微信掃一掃加我為好友
QQ號聯系: 360901061
您的支持是博主寫作最大的動力,如果您喜歡我的文章,感覺我的文章對您有幫助,請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點擊下面給點支持吧,站長非常感激您!手機微信長按不能支付解決辦法:請將微信支付二維碼保存到相冊,切換到微信,然后點擊微信右上角掃一掃功能,選擇支付二維碼完成支付。
【本文對您有幫助就好】元
