點擊上方藍色字體，選擇「標星公衆號」
java
優質文章，第一時間送達web
做者 | 野狼谷spring
來源 | urlify.cn/qqMBnqexpress
項目開發中常常須要執行一些定時任務，好比須要在天天凌晨時候，分析一次前一天的日誌信息。Spring爲咱們提供了異步執行任務調度的方式，提供TaskExecutor 、TaskScheduler 接口。微信
SpringBoot中使用兩個註解：@EnableScheduling、@Scheduled來簡單實現定時任務。
app
@Scheduled參數詳解
1. cron
該參數接收一個cron表達式，cron表達式是一個字符串，字符串以5或6個空格隔開，分開共6或7個域，每個域表明一個含義。異步
cron表達式語法
[秒] [分] [小時] [日] [月] [周] [年]
注：[年]不是必須的域，能夠省略[年]，則一共6個域編輯器
| 序號 | 說明 | 必填 | 容許填寫的值 | 容許的通配符 |
|---|---|---|---|---|
| 1 | 秒 | 是 | 0-59 | , - * / |
| 2 | 分 | 是 | 0-59 | , - * / |
| 3 | 時 | 是 | 0-23 | , - * / |
| 4 | 日 | 是 | 1-31 | , - * ? / L W |
| 5 | 月 | 是 | 1-12 / JAN-DEC | , - * / |
| 6 | 周 | 是 | 1-7 or SUN-SAT | , - * ? / L # |
| 7 | 年 | 否 | 1970-2099 | , - * / |
通配符說明:
*表示全部值。例如:在分的字段上設置 *,表示每一分鐘都會觸發。ide?表示不指定值。使用的場景爲不須要關心當前設置這個字段的值。例如:要在每個月的10號觸發一個操做，但不關心是周幾，因此須要周位置的那個字段設置爲」?」 具體設置爲 0 0 0 10 * ?-表示區間。例如 在小時上設置 「10-12」,表示 10,11,12點都會觸發。,表示指定多個值，例如在周字段上設置 「MON,WED,FRI」 表示週一，週三和週五觸發/用於遞增觸發。如在秒上面設置」5/15」 表示從5秒開始，每增15秒觸發(5,20,35,50)。在月字段上設置’1/3’所示每個月1號開始，每隔三天觸發一次。L表示最後的意思。在日字段設置上，表示當月的最後一天(依據當前月份，若是是二月還會依據是不是潤年[leap]), 在周字段上表示星期六，至關於」7」或」SAT」。若是在」L」前加上數字，則表示該數據的最後一個。例如在周字段上設置」6L」這樣的格式,則表示「本月最後一個星期五」W表示離指定日期的最近那個工做日(週一至週五). 例如在日字段上置」15W」，表示離每個月15號最近的那個工做日觸發。若是15號正好是週六，則找最近的週五(14號)觸發, 若是15號是周未，則找最近的下週一(16號)觸發.若是15號正好在工做日(週一至週五)，則就在該天觸發。若是指定格式爲 「1W」,它則表示每個月1號日後最近的工做日觸發。若是1號正是週六，則將在3號下週一觸發。(注，」W」前只能設置具體的數字,不容許區間」-「)。#序號(表示每個月的第幾個周幾)，例如在周字段上設置」6#3」表示在每個月的第三個週六.注意若是指定」#5」,正好第五週沒有周六，則不會觸發該配置(用在母親節和父親節再合適不過了) ；小提示：’L’和 ‘W’能夠一組合使用。若是在日字段上設置」LW」,則表示在本月的最後一個工做日觸發；周字段的設置，若使用英文字母是不區分大小寫的，即MON與mon相同。
示例
每隔5秒執行一次：*/5 * * * * ?
每隔1分鐘執行一次：0 */1 * * * ?
天天23點執行一次：0 0 23 * * ?
天天凌晨1點執行一次：0 0 1 * * ?
每個月1號凌晨1點執行一次：0 0 1 1 * ?
每個月最後一天23點執行一次：0 0 23 L * ?
每週星期天凌晨1點實行一次：0 0 1 ? * L
在26分、29分、33分執行一次：0 26,29,33 * * * ?
天天的0點、13點、18點、21點都執行一次：0 0 0,13,18,21 * * ?
cron表達式使用佔位符
另外，cron屬性接收的cron表達式支持佔位符。eg：
配置文件：
time:
cron: */5 * * * * *
interval: 5
每5秒執行一次：
@Scheduled(cron="${time.cron}")
void testPlaceholder1() {
System.out.println("Execute at " + System.currentTimeMillis());
}
@Scheduled(cron="*/${time.interval} * * * * *")
void testPlaceholder2() {
System.out.println("Execute at " + System.currentTimeMillis());
}
2. zone
時區，接收一個java.util.TimeZone#ID。cron表達式會基於該時區解析。默認是一個空字符串，即取服務器所在地的時區。好比咱們通常使用的時區Asia/Shanghai。該字段咱們通常留空。
3. fixedDelay
上一次執行完畢時間點以後多長時間再執行。如：
@Scheduled(fixedDelay = 5000) //上一次執行完畢時間點以後5秒再執行
4. fixedDelayString
與 3. fixedDelay 意思相同，只是使用字符串的形式。惟一不一樣的是支持佔位符。如：
@Scheduled(fixedDelayString = "5000") //上一次執行完畢時間點以後5秒再執行
佔位符的使用(配置文件中有配置：time.fixedDelay=5000)：
@Scheduled(fixedDelayString = "${time.fixedDelay}")
void testFixedDelayString() {
System.out.println("Execute at " + System.currentTimeMillis());
}
運行結果：
佔位符的使用
5. fixedRate
上一次開始執行時間點以後多長時間再執行。如：
@Scheduled(fixedRate = 5000) //上一次開始執行時間點以後5秒再執行
6. fixedRateString
與 5. fixedRate 意思相同，只是使用字符串的形式。惟一不一樣的是支持佔位符。
7. initialDelay
第一次延遲多長時間後再執行。如：
@Scheduled(initialDelay=1000, fixedRate=5000) //第一次延遲1秒後執行，以後按fixedRate的規則每5秒執行一次
8. initialDelayString
與 7. initialDelay 意思相同，只是使用字符串的形式。惟一不一樣的是支持佔位符。
That's all ! Thanks for reading.
附：
截至spring-context-4.3.14.RELEASE的源碼
/**
* An annotation that marks a method to be scheduled. Exactly one of
* the {@link #cron()}, {@link #fixedDelay()}, or {@link #fixedRate()}
* attributes must be specified.
*
* <p>The annotated method must expect no arguments. It will typically have
* a {@code void} return type; if not, the returned value will be ignored
* when called through the scheduler.
*
* <p>Processing of {@code @Scheduled} annotations is performed by
* registering a {@link ScheduledAnnotationBeanPostProcessor}. This can be
* done manually or, more conveniently, through the {@code <task:annotation-driven/>}
* element or @{@link EnableScheduling} annotation.
*
* <p>This annotation may be used as a <em>meta-annotation</em> to create custom
* <em>composed annotations</em> with attribute overrides.
*
* @author Mark Fisher
* @author Dave Syer
* @author Chris Beams
* @since 3.0
* @see EnableScheduling
* @see ScheduledAnnotationBeanPostProcessor
* @see Schedules
*/
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Repeatable(Schedules.class)
public @interface Scheduled {
/**
* A cron-like expression, extending the usual UN*X definition to include
* triggers on the second as well as minute, hour, day of month, month
* and day of week. e.g. {@code "0 * * * * MON-FRI"} means once per minute on
* weekdays (at the top of the minute - the 0th second).
* @return an expression that can be parsed to a cron schedule
* @see org.springframework.scheduling.support.CronSequenceGenerator
*/
String cron() default "";
/**
* A time zone for which the cron expression will be resolved. By default, this
* attribute is the empty String (i.e. the server's local time zone will be used).
* @return a zone id accepted by {@link java.util.TimeZone#getTimeZone(String)},
* or an empty String to indicate the server's default time zone
* @since 4.0
* @see org.springframework.scheduling.support.CronTrigger#CronTrigger(String, java.util.TimeZone)
* @see java.util.TimeZone
*/
String zone() default "";
/**
* Execute the annotated method with a fixed period in milliseconds between the
* end of the last invocation and the start of the next.
* @return the delay in milliseconds
*/
long fixedDelay() default -1;
/**
* Execute the annotated method with a fixed period in milliseconds between the
* end of the last invocation and the start of the next.
* @return the delay in milliseconds as a String value, e.g. a placeholder
* @since 3.2.2
*/
String fixedDelayString() default "";
/**
* Execute the annotated method with a fixed period in milliseconds between
* invocations.
* @return the period in milliseconds
*/
long fixedRate() default -1;
/**
* Execute the annotated method with a fixed period in milliseconds between
* invocations.
* @return the period in milliseconds as a String value, e.g. a placeholder
* @since 3.2.2
*/
String fixedRateString() default "";
/**
* Number of milliseconds to delay before the first execution of a
* {@link #fixedRate()} or {@link #fixedDelay()} task.
* @return the initial delay in milliseconds
* @since 3.2
*/
long initialDelay() default -1;
String initialDelayString() default "";
}
粉絲福利：Java從入門到入土學習路線圖
👇👇👇
👆長按上方微信二維碼 2 秒
感謝點贊支持下哈
本文分享自微信公衆號 - java1234（gh_27ed55ecb177）。
若有侵權，請聯繫 support@oschina.cn 刪除。
本文參與「OSC源創計劃」，歡迎正在閱讀的你也加入，一塊兒分享。