转 Spring的定时器说明文档

时间:2020-12-21 05:41:20

Spring的定时器说明文档

 

关于简单触发器和复杂触发器,查考下面的解释:

Quartz设计者做了一个设计选择来从调度分离开作业。Quartz中的触发器用来告诉调度程序作业什么时候触发。框架提供了一把触发器类型,但两个最常用的是SimpleTriggerCronTriggerSimpleTrigger为需要简单打火调度而设计。典型地,如果你需要在给定的时间和重复次数或者两次打火之间等待的秒数打火一个作业,那么SimpleTrigger适合你。另一方面,如果你有许多复杂的作业调度,那么或许需要CronTrigger

CronTrigger是基于Calendar-like调度的。当你需要在除星期六和星期天外的每天上午10点半执行作业时,那么应该使用CronTrigger。正如它的名字所暗示的那样,CronTrigger是基于Unix克隆表达式的。

 

<bean id="mcScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">

       <property name="triggers">

           <list>

              <ref bean="dealBalanceTimeoutTrigger"/>

              <ref bean="footBallAutoOrderTrigger"/>

           </list>

       </property>

</bean>  //以上是调度程序bean的相关配置,其中dealBalanceTimeoutTriggerfootBallAutoOrderTrigger是两个计时器

 

 

<bean id="dealBalanceTimeoutTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerBean">

       <property name="jobDetail">

           <bean class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">

              <property name="targetObject" ref="ztTryMatchingService"/>

              <property name="targetMethod" value="balanceDisabled"/>

           </bean>

       </property>

       <property name="repeatCount"><value>-1</value></property>

       <property name="repeatInterval"><value>10000</value></property>

       <property name="startDelay"><value>5000</value></property>

    </bean>

//以上这个计时器是一个SimpleTraiggerBean的实例,其中的jobDetail是用来设置定时器按时调用哪个类的哪个方法的,值得说明的是被调用的这个类不需是通过spring管理的,而且这个类的这个方法必须是一个无参数的,void返回类型的函数,应该是public的。repeatCount对应重复次数(-1表示无限重复);repeatInterval重复间隔;startDelay服务器启动后多久开始启动。

 

 

<bean id="footBallAutoOrderTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">

       <property name="jobDetail">

          <bean class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">

              <property name="targetObject" ref="footBallAutoOrder"/>

              <property name="targetMethod" value="autoOrder"/>

           </bean>

       </property>

       <property name="cronExpression">

            <value>0 5 0 ? * 4</value>

       </property>

   </bean>

//以上这个计时器是一个CronTriggerBean的实例,其中的jobDetail属性跟上面的计时器一样;cronExpression属性用来描述定时器什么时间怎么运行(0 5 0 ? * 4的意思是每周三凌晨零点过五分自动运行),表达式说明如下:

 

 

关于cronExpression的介绍

2008-03-27 18:58

一个Cron-表达式是一个由六至七个字段组成由空格分隔的字符串,其中6个字段是必须的而一个是可选的,如下:

字段名

 

允许的值

 

允许的特殊字符

 

0-59

 

, - * /

 

0-59

 

, - * /

小时

 

0-23

 

, - * /

 

1-31

 

, - * ? / L W C

 

1-12 or JAN-DEC

 

, - * /

周几

 

1-7 or SUN-SAT

 

, - * ? / L C #

(可选字段)

 

empty, 1970-2099

 

, - * /

'*' 字符可以用于所有字段,在字段中设为"*"表示"每一分钟"的含义。

'?' 字符可以用在周几字段. 它用来指定 '不明确的值'. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。

'-' 字符被用来指定一个值的范围,比如在小时字段中设为"10-12"表示"10点到12".

',' 字符指定数个值。比如在周几字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".

'/' 字符用来指定一个值的的增加幅度. 比如在字段中设置为"0/15"表示"0, 15, 30, 45"。而 "5/15"则表示"5, 20, 35, 50". '/'前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于字段来说,其数值范围为059,对于小时字段来说其为023, 对于字段来说为031, 而对于字段来说为112"/"字段仅仅只是帮助你在允许的数值范围内从开始"n"的值。 因此 对于字段来说"7/6"只是表示7月被开启而不是每六个月”, 请注意其中微妙的差别。

'L'字符可用在周几这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号(非闰年)。而在周几字段中, 它简单的表示"7" or "SAT",但是如果在周几字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如" 6L "表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要,否则你会被结果搞糊涂的。

'W' 可用于字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将字段设为"15W",意为: "离该月15号最近的工作日"。因此如果15号为周六,触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于字段的值为单独的一天而不是一系列值的时候。

'L''W'可以组合用于字段表示为'LW',意为"该月最后一个工作日"

'#' 字符可用于周几字段。该字符表示该月第几个周×”,比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个×”,该月是不会触发的。

'C' 字符可用于周几字段,它是"calendar"的缩写。 它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历, 那它等同于包含全部日历。字段值为" 5C "表示"日历中的第一天或者5号以后"周几字段值为" 1C "则表示"日历中的第一天或者周日以后"

对于月份字段和周几字段来说合法的字符都不是大小写敏感的。

下面是一些完整的例子:

表达式

 

含义

"0 0 12 * * ?"

 

每天中午十二点触发

"0 15 10 ? * *"

 

每天早上1015触发

"0 15 10 * * ?"

 

每天早上1015触发

"0 15 10 * * ? *"

 

每天早上1015触发

"0 15 10 * * ? 2005"

 

2005年的每天早上1015触发

"0 * 14 * * ?"

 

每天从下午2点开始到259分每分钟一次触发

"0 0/5 14 * * ?"

 

每天从下午2点开始到255分结束每5分钟一次触发

"0 0/5 14,18 * * ?"

 

每天的下午2点至2556点至655分两个时间段内每5分钟一次触发

"0 0-5 14 * * ?"

 

每天14:0014:05每分钟一次触发

"0 10,44 14 ? 3 WED"

 

三月的每周三的14101444触发

"0 15 10 ? * MON-FRI"

 

每个周一、周二、周三、周四、周五的1015触发

"0 15 10 15 * ?"

 

每月15号的1015触发

"0 15 10 L * ?"

 

每月的最后一天的1015触发

"0 15 10 ? * 6L "

 

每月最后一个周五的1015触发

"0 15 10 ? * 6L "

 

每月最后一个周五的1015触发

"0 15 10 ? * 6L 2002-2005"

 

2002年至2005年的每月最后一个周五的1015触发

"0 15 10 ? * 6#3"

 

每月的第三个周五的1015触发