以下轉載出處:https://www.cnblogs.com/liuyitian/p/4108391.html
最近做的項目有用到定時器,每週只在特定時間運行一次,考慮到Spring Task的簡單易用性,就果斷選擇了,我是配置在配置文件裏面,沒有用註解@Scheduled,推薦配置,註解雖方便,但更改需求時,需要代碼重新編譯。
定時任務配置其實很簡單,不再贅述,自行度娘。關鍵就是方法執行時機,Spring用cron字符串表達式來做設置。
服務器啓動的時候立馬執行一次
<task:scheduled ref="beanID" method="方法名" initial-delay="延遲毫秒" fixed-delay="週期毫秒" />
注意:initial-delay和fixed-delay屬性在spring 3.2版本以上有效,3.0就沒有,並且3.2以上定時任務,服務器啓動完成後會自動執行一次定時任務的,無需自己觸發,如果有多個任務,initial-delay屬性可以設置任務的等待時間,來解決任務的先後執行順序。
Cron表達式:
Cron表達式是一個字符串,字符串以5或6個空格隔開,分爲6或7個域,每一個域代表一個含義,Cron有如下兩種語法格式:
Seconds Minutes Hours DayofMonth Month DayofWeek Year或
Seconds Minutes Hours DayofMonth Month DayofWeek
每一個域可出現的字符如下:
Seconds:可出現", - * /"四個字符,有效範圍爲0-59的整數
Minutes:可出現", - * /"四個字符,有效範圍爲0-59的整數
Hours:可出現", - * /"四個字符,有效範圍爲0-23的整數
DayofMonth:可出現", - * / ? L W C"八個字符,有效範圍爲0-31的整數
Month:可出現", - * /"四個字符,有效範圍爲1-12的整數或JAN-DEc
DayofWeek:可出現", - * / ? L C #"四個字符,有效範圍爲1-7的整數或SUN-SAT兩個範圍。1表示星期天,2表示星期一, 依次類推
Year:可出現", - * /"四個字符,有效範圍爲1970-2099年
每一個域都使用數字,但還可以出現如下特殊字符,它們的含義是:
(1)*:表示匹配該域的任意值,假如在Minutes域使用*, 即表示每分鐘都會觸發事件。
(2)?:只能用在DayofMonth和DayofWeek兩個域。它也匹配域的任意值,但實際不會。因爲DayofMonth和 DayofWeek會相互影響。例如想在每月的20日觸發調度,不管20日到底是星期幾,則只能使用如下寫法: 13 13 15 20 * ?, 其中最後一位只能用?,而不能使用*,如果使用*表示不管星期幾都會觸發,實際上並不是這樣。
(3)-:表示範圍,例如在Minutes域使用5-20,表示從5分到20分鐘每分鐘觸發一次
(4)/:表示起始時間開始觸發,然後每隔固定時間觸發一次,例如在Minutes域使用5/20,則意味着5分鐘觸發一次,而25,45等分別觸發一次.
(5),:表示列出枚舉值值。例如:在Minutes域使用5,20,則意味着在5和20分每分鐘觸發一次。
(6)L:表示最後,只能出現在DayofWeek和DayofMonth域,如果在DayofWeek域使用5L,意味着在最後的一個星期四觸發。
(7)W: 表示有效工作日(週一到週五),只能出現在DayofMonth域,系統將在離指定日期的最近的有效工作日觸發事件。例如:在 DayofMonth使用5W,如果5日是星期六,則將在最近的工作日:星期五,即4日觸發。如果5日是星期天,則在6日(週一)觸發;如果5日在星期一 到星期五中的一天,則就在5日觸發。另外一點,W的最近尋找不會跨過月份
(8)LW:這兩個字符可以連用,表示在某個月最後一個工作日,即最後一個星期五。
(9)#:用於確定每個月第幾個星期幾,只能出現在DayofMonth域。例如在4#2,表示某月的第二個星期三。
舉幾個例子:
0 0 2 1 * ? * 表示在每月的1日的凌晨2點調度任務
0 15 10 ? * MON-FRI 表示週一到週五每天上午10:15執行作業
0 15 10 ? 6L 2002-2006 表示2002-2006年的每個月的最後一個星期五上午10:15執行作
一個cron表達式有至少6個(也可能7個)有空格分隔的時間元素。
按順序依次爲
秒(0~59)
分鐘(0~59)
小時(0~23)
天(月)(0~31,但是你需要考慮你月的天數)
月(0~11)
天(星期)(1~7 1=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT)
年份(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點
"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觸發
有些子表達式能包含一些範圍或列表
例如:子表達式(天(星期))可以爲 “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”參數時,不要指定列表或範圍,因爲這會導致問題
字段 允許值 允許的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小時 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年(可選) 留空, 1970-2099 , - * /
以下開發配置轉載出處:https://www.cnblogs.com/hongwz/p/5642497.html
Spring任務調度之Spring-Task配置及使用
一.前言
上面兩篇介紹了在Spring 中使用Timer與Quartz,本篇將介紹Spring3.0以後自主開發的定時任務工具,spring task,可以將它比作一個輕量級的Quartz,而且使用起來很簡單,除spring相關的包外不需要額外的包,而且支持註解和配置文件兩種形式,下面將分別介紹這兩種方式。
二、第一種:配置文件方式
第一步:編寫作業類
即普通的pojo,如下:
1
2
3
4
5
6
7
8
|
import org.springframework.stereotype.Service; @Service public class TaskJob
{ public void job1()
{ System.out.println(“任務進行中。。。”); } } |
第二步:spring配置
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:task="http://www.springframework.org/schema/task"
......
xsi:schemaLocation="http://www.springframework.org/schema/task http://www.springframework.org/schema/task/spring-task-3.0.xsd">
<task:scheduled-tasks>
<task:scheduled ref="taskJob" method="job1" cron="0 * * * * ?"/>
</task:scheduled-tasks>
<context:component-scan base-package=" com.gy.mytask " />
</beans>
說明:ref參數指定的即任務類,method指定的即需要運行的方法,cron及cronExpression表達式。<context:component-scan base-package="com.gy.mytask" />這個配置不消多說了,spring掃描註解用的。
第二種:使用註解形式
也許我們不想每寫一個任務類還要在xml文件中配置下,我們可以使用註解@Scheduled,我們看看源文件中該註解的定義:
1
2
3
4
5
6
7
8
9
10
11
|
@Target ({java.lang.annotation.ElementType.METHOD,
java.lang.annotation.ElementType.ANNOTATION_TYPE}) @Retention (RetentionPolicy.RUNTIME) @Documented public @interface Scheduled { public abstract String
cron(); public abstract long fixedDelay(); public abstract long fixedRate(); } |
可以看出該註解有三個方法或者叫參數,分別表示的意思是:
cron:指定cron表達式。
fixedDelay:官方文檔解釋:An interval-based trigger where the interval is measured from the completion time of the previous task. The time unit value is measured in milliseconds.即表示從 上一個任務完成開始到下一個任務開始的間隔,單位是毫秒。
fixedRate:官方文檔解釋:An interval-based trigger where the interval is measured from the start time of the previous task. The time unit value is measured in milliseconds.即從上一個任務 開始到下一個任務開始的間隔,單位是毫秒。
第一步:編寫pojo
1
2
3
4
5
6
7
8
9
|
import org.springframework.stereotype.Component; @Component (“taskJob”) public class TaskJob
{ @Scheduled (cron
= "0
0 3 * * ?" ) public void job1()
{ System.out.println(“任務進行中。。。”); } } |
第二步:添加task相關的配置:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
<?xml
version= "1.0" encoding= "UTF-8" ?> <beans
xmlns= "http://www.springframework.org/schema/beans" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xmlns:aop= "http://www.springframework.org/schema/aop" xmlns:context= "http://www.springframework.org/schema/context" xmlns:tx= "http://www.springframework.org/schema/tx" xmlns:task= "http://www.springframework.org/schema/task" xsi:schemaLocation=" http: //www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http: //www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd http: //www.springframework.org/schema/context http: //www.springframework.org/schema/jdbc/spring-jdbc-3.0.xsd http: //www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd http: //www.springframework.org/schema/task
http://www.springframework.org/schema/task/spring-task-3.0.xsd" default -lazy-init= "false" > <context:annotation-config
/> <!—spring掃描註解的配置
—> <context:component-scan
base- package = "com.gy.mytask" /> <!—開啓這個配置,spring才能識別 @Scheduled 註解
—> <task:annotation-driven
scheduler= "qbScheduler" mode= "proxy" /> <task:scheduler
id= "qbScheduler" pool-size= "10" /> |
說明:理論上只需要加上<task:annotation-driven />這句配置就可以了,這些參數都不是必須的。
配置完畢,spring task還有很多參數,具體參考xsd文檔 http://www.springframework.org/schema/task/spring-task-3.0.xsd