1. 程式人生 > >Spring+quartz使用小結

Spring+quartz使用小結

上一個功能模組做完了,這次做的是行為規則設定的模組,需要定時啟動執行任務,不多說,必然是使用quartz來進行操作。單獨quartz元件沒有使用過,直接和spring整合好了,使用很簡單,現在總結一下用法:

使用quartz建立定時任務有2種方式:

1、業務類實現org.quartz.job這個介面即可。

2、業務類不需要繼承、實現任何類或介面。

第一種方式,配置省事一點(其實真感覺就是幾行字分分鐘的事),但是耦合性還是不太好吧,只能這麼說了。第二種方式比較靈活、簡單,推薦第二種方式。不過本著學習態度,一併總結。

1、先說第一種實現介面,你需要實現一個方法如下:

public class test1 implements Job{

	@Override
	public void execute(JobExecutionContext arg0) throws JobExecutionException {
		// TODO Auto-generated method stub
		
	}

}
你的業務邏輯可以寫在這裡或者其他方法裡都可以。接下來是application-context的配置:
<bean name="timedTask" class="org.springframework.scheduling.quartz.JobDetailBean">
			<property name="jobClass" value="com.capinfo.crm.market.business.impl.TimedTaskBusinessImpl"></property>
		</bean> 
<!-- 觸發器 -->
		<bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">
			<property name="jobDetail" ref="timedTask"></property>
			<property name="cronExpression" value="0/10 * * * * ?"></property>
		</bean>
		

		<!-- 排程器 -->
		<bean class="org.springframework.scheduling.quartz.SchedulerBean">
			<property name="triggers">
				<list>
					<!-- 觸發器列表 -->
					<ref bean="cronTrigger"/>
				</list>
			</property>
		</bean>

分別需要配置你的業務類,將其注入給JobDetailBean,之後配置觸發器(其實就是觸發時間規則)和排程器(排程器可以理解繫結觸發器和業務類),完成之後就可以執行了,該配置是每10S執行一次,關於cronExpression將在最後進行總結。另外提醒一下,如果你的quartz版本是在2.0以下,這樣配置是沒有問題的,如果是2.0以上,這樣配置會報錯,具體什麼錯,稍後介紹。

2、接下來說一下靈活性較高的方法,業務類沒什麼特殊的,不需要繼承quartz類或者什麼介面,所以這裡不貼業務類了,貼了也沒用。。直接貼上application-context的配置檔案:

<bean name="timedTaskBusiness" class="com.capinfo.crm.market.business.impl.TimedTaskBusinessImpl"/>
		
		<bean id="timedTask" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailBean">
			<property name="targetObject" ref="timedTaskBusiness"/>
			<property name="targetMethod" value="perform"/>
		</bean>
		
		
		<!-- 觸發器 -->
		<bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">
			<property name="jobDetail" ref="timedTask"></property>
			<property name="cronExpression" value="0/10 * * * * ?"></property>
		</bean>
		

		<!-- 排程器 -->
		<bean class="org.springframework.scheduling.quartz.SchedulerBean">
			<property name="triggers">
				<list>
					<!-- 觸發器列表 -->
					<ref bean="cronTrigger"/>
				</list>
			</property>
		</bean>
其實不難發現只是業務類配置有一點小小改動,注入給MethodInvokingJobDetailBean明確的類和方法名即可。

如上2種方法配置以後,quartz2以上版本的啟動伺服器就會報錯了,class org.springframework.scheduling.quartz.JobDetailBean has interface org.quartz.JobDetail as super class ,查了半天,才知道quartz2修改了一些api,解決方法如下

Spring官網有說明其已支援Quartz 2.x,但是需要將Spring升級到3.1以上。由於Quartz 2.x修改了部分API,所以需要修改一下Quartz的配置。大體來說很簡單,如下:

1)升級Spring的jar包

2)升級Quartz的jar包

3)修改配置

  • 將CronTriggerBean修改為CronTriggerFactoryBean
  • 將JobDetailBean修改為JobDetailFactoryBean
這裡,採取第三種方法,將上述的配置檔案改成CronTriggerFactoryBean、JobDetailFactoryBean就好了。

好了,現在這個錯誤過去了。

如果你在使用quartz的時候,報錯誤

拋異常 SchedulerException: Jobs added with no trigger must be durable.

意思是沒有給job新增觸發器,你可以在配置檔案中加上durable屬性即可。// durable, 指明任務就算沒有繫結Trigger仍保留在Quartz的JobStore中,如下:

<bean name="timedTask" class="org.springframework.scheduling.quartz.JobDetailFactoryBean">
			<property name="Durability" value="true"/>
			<property name="jobClass" value="com.capinfo.crm.market.business.impl.TimedTaskBusinessImpl"></property>
下面把cronExpression貼上,需要注意的是下面的紅色字型,在配置cronExpression時候,在“月份中的日期”和“星期中的日期”2個欄位中,必須要設定其中一個為?,否則是不會執行的!

按順序依次為 
秒(0~59) 
分鐘(0~59) 
小時(0~23) 
天(月)(0~31,但是你需要考慮你月的天數)
月(0~11) 
天(星期)(1~7 1=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT) 
7.年份(1970-2099) 


其中每個元素可以是一個值(如6),一個連續區間(9-12),一個間隔時間(8-18/4)(/表示每隔4小時),一個列表(1,3,5),萬用字元。由於"月份中的日期"和"星期中的日期"這兩個元素互斥的,必須要對其中一個設定?. 
0 0 10,14,16 * * ? 每天上午10點,下午2點,4點 
0 0/30 9-17 * * ?   朝九晚五工作時間內每半小時 
0 0 12 ? * WED 表示每個星期三中午12點 
有些子表示式能包含一些範圍或列表 
例如:子表示式(天(星期))可以為 “MON-FRI”,“MON,WED,FRI”,“MON-WED,SAT” 
“*”字元代表所有可能的值 
因此,“*”在子表示式(月)裡表示每個月的含義,“*”在子表示式(天(星期))表示星期的每一天 


“/”字元用來指定數值的增量 
例如:在子表示式(分鐘)裡的“0/15”表示從第0分鐘開始,每15分鐘 
         在子表示式(分鐘)裡的“3/20”表示從第3分鐘開始,每20分鐘(它和“3,23,43”)的含義一樣 


“?”字元僅被用於天(月)和天(星期)兩個子表示式,表示不指定值 
當2個子表示式其中之一被指定了值以後,為了避免衝突,需要將另一個子表示式的值設為“?” 


“L” 字元僅被用於天(月)和天(星期)兩個子表示式,它是單詞“last”的縮寫 
但是它在兩個子表示式裡的含義是不同的。 
在天(月)子表示式中,“L”表示一個月的最後一天 
在天(星期)自表示式中,“L”表示一個星期的最後一天,也就是SAT 
如果在“L”前有具體的內容,它就具有其他的含義了 
例如:“6L”表示這個月的倒數第6天,“FRIL”表示這個月的最一個星期五 
注意:在使用“L”引數時,不要指定列表或範圍,因為這會導致問題 






附:cronExpression配置說明 


欄位 允許值 允許的特殊字元 
秒 0-59 , - * / 
分 0-59 , - * / 
小時 0-23 , - * / 
日期 1-31 , - * ? / L W C 
月份 1-12 或者 JAN-DEC , - * / 
星期 1-7 或者 SUN-SAT , - * ? / L C # 
年(可選) 留空, 1970-2099 , - * / 
表示式 意義 
"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觸發 
特殊字元 意義 
* 表示所有值; 
? 表示未說明的值,即不關心它為何值; 
- 表示一個指定的範圍; 
, 表示附加一個可能值; 
/ 符號前表示開始時間,符號後表示每次遞增的值; 
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的第一天。

最後把我的配置檔案完整的貼上來:

<bean name="timedTaskBusiness" class="com.capinfo.crm.market.business.impl.TimedTaskBusinessImpl"/>

		<bean id="timedTask" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
			<property name="targetObject" ref="timedTaskBusiness"/>
			<property name="targetMethod" value="perform"/>
		</bean>
		
		
		<!-- 觸發器 -->
		<bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
			<property name="jobDetail" ref="timedTask"></property>
			<property name="cronExpression" value="0/10 * * * * ?"></property>
		</bean>
		

		<!-- 排程器 -->
		<bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
			<property name="triggers">
				<list>
					<!-- 觸發器列表 -->
					<ref bean="cronTrigger"/>
				</list>
			</property>
		</bean>