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>


你可能感兴趣的:(spring,quartz)