什麼是動態定時任務:是由客戶制定生成的,服務端只知道該去執行什麼任務,但任務的定時是不確定的(是由客戶制定)。
這樣總不能修改配置文件每定製個定時任務就增加一個trigger吧,即便允許客戶修改配置文件,
但總需要重新啓動web服務啊,研究了下Quartz在Spring中的動態定時,發現<bean id="cronTrigger"
class="org.springframework.scheduling.quartz.CronTriggerBean" >
<property name="jobDetail" ref="schedulerJobDetail"/>
<property name="cronExpression">
<value>0/10 * * * * ?</value>
</property>
中cronExpression是關鍵,如果可以動態設置cronExpression
的值,也就說如果我們可以直接調用CronTriggerBean中設置cronExpression
的方法,就可以順利解決問題了。
熟悉1的朋友可以跳過不看,下面2、3是動態定時任務的具體實現。
1.
Quartz在Spring中的簡單配置
Spring配置文件:
<bean id="schedulerJobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
<property name="targetObject" ref="scheduleInfoAction"/>
<property name="targetMethod
" value="simpleJobTest
"/>
<property name="concurrent" value="false"/>
</bean>
<bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean" >
<property name="jobDetail" ref="schedulerJobDetail"/>
<property name="cronExpression
">
<value>0/10 * * * * ?</value>
</property>
</bean>
<bean id="schedulerFactory" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<list>
<ref local="cronTrigger"/>
</list>
</property>
</bean>
在上面的配置中設定了
① targetMethod:
指定需要定時執行scheduleInfoAction中的simpleJobTest()方法
② concurrent:對於相同的JobDetail,當指定多個Trigger時, 很可能第一個job完成之前,第二個job就開始了。指定concurrent設爲false,多個job不會併發運行,第二個job將不會在第一個job完成之前開始。
③ cronExpression
:0/10 * * * * ?表示每10秒執行一次,具體可參考附表
。
④ triggers:通過再添加其他的ref元素可在list中放置多個觸發器。
scheduleInfoAction中的simpleJobTest()方法
注意:此方法沒有參數,如果scheduleInfoAction有兩個方法simpleJobTest
()和simpleJobTest(String argument),則spring只會去執行無參的simpleJobTest
().
public void simpleJobTest() {
log.warn("uh oh, Job is scheduled !'" + "' Success...");
}
2
.Quartz在Spring中動態設置
cronTrigger方法一
Spring配置文件:
<bean id="scheduleInfoAction" class="com.lively.happyoa.jobs.webapp.action.ScheduleInfoAction">
<property name="scheduler
" ref="schedulerFactory"/>
<property name="scheduleInfoManager
" ref="scheduleInfoManager"/>
</bean>
<bean id="schedulerJobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
<property name="targetObject" ref="scheduleInfoAction"/>
<property name="targetMethod" value="reScheduleJob
"/>
<property name="concurrent" value="false"/>
</bean>
<bean id="cronTrigger
" class="org.springframework.scheduling.quartz.CronTriggerBean" >
<property name="jobDetail" ref="schedulerJobDetail"/>
<property name="cronExpression
">
<value>0/10 * * * * ?</value>
</property>
</bean>
<bean id="schedulerFactory" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<list>
<ref local="cronTrigger"/>
</list>
</property>
</bean>
scheduleInfoAction中的reScheduleJob
()方法及相關方法
① reScheduleJob
讀取數據庫,獲得自定義定時器調度時間
():
private void reScheduleJob
() throws SchedulerException, ParseException {
//
運行時可通過動態注入的scheduler得到trigger
CronTriggerBean trigger = (CronTriggerBean) scheduler.getTrigger(
"cronTrigger
", Scheduler.DEFAULT_GROUP);
String dbCronExpression = getCronExpressionFromDB
();
String originConExpression = trigger.getCronExpression();
//
判斷從DB中取得的任務時間(dbCronExpression)和現在的quartz線程中的任務時間(originConExpression)是否相等
//
如果相等,則表示用戶並沒有重新設定數據庫中的任務時間,這種情況不需要重新rescheduleJob
if(!originConExpression.equalsIgnoreCase(dbCronExpression)){
trigger.setCronExpression(dbCronExpression);
scheduler.rescheduleJob("cronTrigger
", Scheduler.DEFAULT_GROUP, trigger);
}
//
下面是具體的job內容,可自行設置
// executeJobDetail();
}
② getCronExpressionFromDB()
:從數據庫中獲得dbCronExpression的具體代碼,由於使用了scheduleInfoManager,所以要在定義相應的setter方法
private String getCronExpressionFromDB
(){
String sql="from ScheduleInfo scheduleInfo where 1=1 ";
sql=sql+" and scheduleInfo.infoId = '"+"1" + "'";
List scheduleList = scheduleInfoManager.queryScheduleInListBySql(sql);
ScheduleInfo scheduleInfo = (ScheduleInfo)scheduleList.get(0);
String dbCronExpression = scheduleInfo.getCronExpression();
return dbCronExpression;
}
③ 在spring配置文件的scheduleInfoAction配置了相應的property(scheduler
/ scheduleInfoManager
),要爲其設置setter方法
private Scheduler scheduler;
//
設值注入,通過setter方法傳入被調用者的實例scheduler
public void setScheduler
(Scheduler scheduler) {
this.scheduler = scheduler;
}
private ScheduleInfoManager scheduleInfoManager;
//
設值注入,通過setter方法傳入被調用者的實例scheduleInfoManager
public void setScheduleInfoManager
(ScheduleInfoManager scheduleInfoManager){
this.scheduleInfoManager = scheduleInfoManager;
}
3.
Quartz在Spring中動態設置
cronTrigger方法二
在上面的2中我們可以看到,儘管已經可以動態進行rescheduleJob
了,不過依然需要我們設置一個cronExpression
,如果嘗試一下拿掉spring配置中的
<property name="cronExpression
">
<value>0/10 * * * * ?</value>
</property>
則容器(如tomcat)啓動時會報錯。
實際中我們希望tomcat啓動時就可以直接去讀數據庫,拿到相應的dbCronExpression,然後定時執行一個job,而不希望配置初始的cronExpression
,觀察下面的CronTriggerBean,考慮到cronExpression
需要初始化,如果設定一個類InitializingCronTrigger
繼承CronTriggerBean,然後在這個類中做一些讀取DB的初始化工作(設置cronExpression
),問題就可以解決了。
Spring配置文件:
<bean id="scheduleInfoAction" class="com.lively.happyoa.jobs.webapp.action.ScheduleInfoAction">
<property name="scheduler
" ref="schedulerFactory"/>
<property name="scheduleInfoManager
" ref="scheduleInfoManager"/>
</bean>
<bean id="schedulerJobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
<property name="targetObject" ref="scheduleInfoAction"/>
<property name="targetMethod" value="reScheduleJob
"/>
<property name="concurrent" value="false"/>
</bean>
<bean id="cronTrigger
" class="com.lively.happyoa.jobs.webapp.action.ScheduleInfoAction.InitializingCronTrigger
">
<property name="jobDetail" ref="schedulerJobDetail"/>
<!--<property name="cronExpression
">
<value>0/10 * * * * ?</value>
</property>-->
<property name="scheduleInfoManager
" ref="scheduleInfoManager"/>
</bean>
<bean id="schedulerFactory" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<list>
<ref local="cronTrigger"/>
</list>
</property>
</bean>
InitializingCronTrigger
中的相關方法
注意:在注入scheduleInfoManager屬性的時候,我們可以去讀取DB任務時間(之所以放在setter方法中,是因爲需要在設置scheduleInfoManager後進行getCronExpressionFromDB
(),否則,也可以①②
邏輯把放在類的構造函數中).
注意InitializingCronTrigger
必須extends
CronTriggerBean
.
public class InitializingCronTrigger extends CronTriggerBean
implements Serializable {
private ScheduleInfoManager scheduleInfoManager;
//
設值注入,通過setter方法傳入被調用者的實例scheduleInfoManager
public void setScheduleInfoManager
(ScheduleInfoManager scheduleInfoManager){
this.scheduleInfoManager = scheduleInfoManager;
//
因爲在getCronExpressionFromDB使用到了scheduleInfoManager,所以
//
必須上一行代碼設置scheduleInfoManager後進行getCronExpressionFromDB
String cronExpression = getCronExpressionFromDB
(); // ①
//
因爲extends CronTriggerBean
,此處調用父類方法初始化cronExpression
setCronExpression
(cronExpression); // ②
}
private String getCronExpressionFromDB
(){
String sql="from ScheduleInfo scheduleInfo where 1=1 ";
sql=sql+" and scheduleInfo.infoId = '"+"1" + "'";
List scheduleList = scheduleInfoManager.queryScheduleInListBySql(sql);
ScheduleInfo scheduleInfo = (ScheduleInfo)scheduleList.get(0);
String dbCronExpression = scheduleInfo.getCronExpression();
return dbCronExpression;
}
……
}
附表:
"0 0 12 * * ?" 每天中午12點觸發
"0 15 10 ? * *" 每天上午10:15觸發
"0 15 10 * * ?" 每天上午10:15觸發
"0 15 10 * * ? *" 每天上午10:15觸發
"0 15 10 * * ? 2005" 2005年的每天上午10:15觸發
"0 * 14 * * ?" 在每天下午2點到下午2:59期間的每1分鐘觸發
"0 0/5 14 * * ?" 在每天下午2點到下午2:55期間的每5分鐘觸發
"0 0/5 14,18 * * ?" 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發
"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 15 * ?" 每月15日上午10:15觸發
"0 15 10 L * ?" 每月最後一日的上午10:15觸發
"0 15 10 ? * 6L" 每月的最後一個星期五上午10:15觸發
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最後一個星期五上午10:15觸發
"0 15 10 ? * 6#3" 每月的第三個星期五上午10:15觸發
至於每個符號 看看例子就好了.很簡單了.
時間設置說明:
1、
秒
|
|
0-59
|
|
, - * /
|
分
|
|
0-59
|
|
, - * /
|
小時
|
|
0-23
|
|
, - * /
|
日期
|
|
1-31
|
|
, - * ? / L W C
|
月份
|
|
1-12 或者 JAN-DEC
|
|
, - * /
|
星期
|
|
1-7 或者 SUN-SAT
|
|
, - * ? / L C #
|
年(可選)
|
|
留空, 1970-2099
|
|
, - * /
|
2、
特殊字符 |
|
意義 |
---|
*
|
|
表示所有值;
|
?
|
|
表示未說明的值,即不關心它爲何值;
|
-
|
|
表示一個指定的範圍;
|
,
|
|
表示附加一個可能值;
|
/
|
|
符號前表示開始時間,符號後表示每次遞增的值;
|
L("last")
|
|
("last") "L"
用在day-of-month字段意思是 "這個月最後一天";用在 day-of-week字段, 它簡單意思是 "7" or "SAT"。
如果在day-of-week字段裏和數字聯合使用,它的意思就是 "這個月的最後一個星期幾" – 例如: "6L" means
"這個月的最後一個星期五". 當我們用“L”時,不指明一個列表值或者範圍是很重要的,不然的話,我們會得到一些意想不到的結果。
|
W("weekday")
|
|
只能用在day-of-
month字段。用來描敘最接近指定天的工作日(週一到週五)。例如:在day-of-month字段用“15W”指“最接近這個月第15天的工作日”,
即如果這個月第15天是週六,那麼觸發器將會在這個月第14天即週五觸發;如果這個月第15天是週日,那麼觸發器將會在這個月第16
天即週一觸發;如果這個月第15天是週二,那麼就在觸發器這天觸發。注意一點:這個用法只會在當前月計算值,不會越過當前月。“W”字符僅能在day-
of-month指明一天,不能是一個範圍或列表。也可以用“LW”來指定這個月的最後一個工作日。
|
#
|
|
只能用在day-of-week字段。用來指定這個月的第幾個周幾。例:在day-of-week字段用"6#3"指這個月第3個週五(6指週五,3指第3個)。如果指定的日期不存在,觸發器就不會觸發。
|
C
|
|
指和calendar聯繫後計算過的值。例:在day-of-month 字段用“5C”指在這個月第5天或之後包括calendar的第一天;在day-of-week字段用“1C”指在這週日或之後包括calendar的第一天。
|
在MONTH和Day Of Week字段裏對字母大小寫不敏感
例子
表達式 |
|
意義 |
---|
"0 0 12 * * ?"
|
|
每天中午12點觸發
|
"0 15 10 ? * *"
|
|
每天上午10:15觸發
|
"0 15 10 * * ?"
|
|
每天上午10:15觸發
|
"0 15 10 * * ? *"
|
|
每天上午10:15觸發
|
"0 15 10 * * ? 2005"
|
|
2005年的每天上午10:15
觸發
|
"0 * 14 * * ?"
|
|
在每天下午2點到下午2:59期間的每1分鐘觸發
|
"0 0/5 14 * * ?"
|
|
在每天下午2點到下午2:55期間的每5分鐘觸發
|
"0 0/5 14,18 * * ?"
|
|
在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發
|
"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 15 * ?"
|
|
每月15日上午10:15觸發
|
"0 15 10 L * ?"
|
|
每月最後一日的上午10:15觸發
|
"0 15 10 ? * 6L"
|
|
每月的最後一個星期五上午10:15觸發
|
"0 15 10 ? * 6L 2002-2005"
|
|
2002年至2005年的每月的最後一個星期五上午10:15觸發
|
"0 15 10 ? * 6#3"
|
|
每月的第三個星期五上午10:15觸發
|