spring-task開發使用整理

以下轉載出處: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



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章