@Scheduled參數(shù)及cron表達(dá)式解釋

@Scheduled支持以下8個參數(shù)

• 1.cron：表達(dá)式，指定任務(wù)在特定時間執(zhí)行；
• 2.fixedDelay：表示上一次任務(wù)執(zhí)行完成后多久再次執(zhí)行，參數(shù)類型為long，單位ms；
• 3.fixedDelayString：與fixedDelay含義一樣，只是參數(shù)類型變?yōu)镾tring；
• 4.fixedRate：表示按一定的頻率執(zhí)行任務(wù)，即每次開始執(zhí)行的時間間隔一致，參數(shù)類型為long，單位ms；
• 5.fixedRateString：與fixedRate的含義一樣，只是將參數(shù)類型變?yōu)镾tring；
• 6.initialDelay：表示延遲多久再第一次執(zhí)行任務(wù)，參數(shù)類型為long，單位ms；
• 7.initialDelayString：與initialDelay的含義一樣，只是將參數(shù)類型變?yōu)镾tring；
• 8.zone：時區(qū)，默認(rèn)為當(dāng)前時區(qū)。

cron表達(dá)式是一個字符串，以空格分開共6個域

• [秒] [分] [時] [日] [月] [周]
• spring自帶的定時任務(wù)cron表達(dá)式不支持年

如圖：

上圖類中有如下源代碼：

private void parse(String expression) throws IllegalArgumentException {
	String[] fields = StringUtils.tokenizeToStringArray(expression, " ");
	if (!areValidCronFields(fields)) {
		throw new IllegalArgumentException(String.format(
				"Cron expression must consist of 6 fields (found %d in \"%s\")", fields.length, expression));
	}
	doParse(fields);
}
private static boolean areValidCronFields(String[] fields) {
	return (fields != null && fields.length == 6);
}

代碼中expression參數(shù)即cron表達(dá)式，所以在spring自帶的定時任務(wù)中正確的cron表達(dá)式只能是6個域，否則會拋出IllegalArgumentException提示：Cron expression must consist of 6 fields（cron表達(dá)式必須由6個域組成）。

通配符說明

• *：表示匹配該域的任意值。在minutes域使用 * 表示每分鐘。在months里表示每個月。在daysOfWeek域表示一周的每一天。
• ?：只能用在daysofMonth和daysofWeek兩個域，表示不指定值，當(dāng)兩個子表達(dá)式其中之一被指定了值以后，為了避免沖突，需要將另一個子表達(dá)式的值設(shè)為 ？。因為daysofMonth和daysofWeek會相互影響。例如想在每月的2號觸發(fā)調(diào)度，不管2號是周幾，則只能使用如下寫法：0 0 0 2 * ?, 其中最后一位只能用?，而不能使用*，如果使用*表示不管周幾都會觸發(fā)。
• -：表示范圍。例如在minutes域使用5-20，表示從5分到20分鐘每分鐘觸發(fā)一次
• /：表示起始時間開始觸發(fā)，然后每隔固定時間觸發(fā)一次。例如在minutes域使用5/20，則意味著從當(dāng)前小時的第5分鐘開每20分鐘觸發(fā)一次。
• ,：表示列出枚舉值。例如：在minutes域使用5,20，則意味著在5分和20分時各觸發(fā)一次。
• L：表示最后，是單詞“l(fā)ast”的縮寫，只能出現(xiàn)在daysofWeek和dayofMonth域。在daysofWeek域使用5L意思是在指定月的最后的一個星期四觸發(fā)。在dayofMonth域使用5L或者FRIL意思是在指定月的倒數(shù)第5天觸發(fā)。在使用L參數(shù)時，不要指定列表或范圍。
• W：表示有效工作日(周一到周五),只能出現(xiàn)在daysofMonth域，系統(tǒng)將在離指定日期的最近的有效工作日觸發(fā)事件。例如：在daysofMonth使用5W，如果5號是周六，則將在最近的工作日周五，即4號觸發(fā)。如果5號是周日，則在6日(周一)觸發(fā)。如果5日在星期一到星期五中的一天，則就在5日觸發(fā)。另外，W的最近尋找不會跨過月份 。
• LW：這兩個字符可以連用，表示指定月的最后一個工作日。
• #：用于確定每個月第幾個周幾，只能出現(xiàn)在daysofMonth域。例如在4#2，表示某月的第二個周三。

常用表達(dá)式示例

• 0/2 * * * * ? 表示每2秒 執(zhí)行任務(wù)
• 0 0/2 * * * ? 表示每2分鐘 執(zhí)行任務(wù)
• 0 0 2 1 * ? 表示在每月的1日的凌晨2點調(diào)整任務(wù)
• 0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15執(zhí)行作業(yè)
• 0 0 10,14,16 * * ? 每天上午10點，下午2點，4點
• 0 0/30 9-17 * * ? 朝九晚五工作時間內(nèi)每半小時
• 0 0 12 ? * WED 表示每個星期三中午12點
• 0 0 12 * * ? 每天中午12點觸發(fā)
• 0 15 10 ? * * 每天上午10:15觸發(fā)
• 0 15 10 * * ? 每天上午10:15觸發(fā)
• 0 15 10 * * ? 每天上午10:15觸發(fā)
• 0 * 14 * * ? 在每天下午2點到下午2:59期間的每1分鐘觸發(fā)
• 0 0/5 14 * * ? 在每天下午2點到下午2:55期間的每5分鐘觸發(fā)
• 0 0/5 14,18 * * ? 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發(fā)
• 0 0-5 14 * * ? 在每天下午2點到下午2:05期間的每1分鐘觸發(fā)
• 0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44觸發(fā)
• 0 15 10 ? * MON-WED,SAT 周一至周三和周六的上午10:15觸發(fā)
• 0 15 10 15 * ? 每月15日上午10:15觸發(fā)
• 0 15 10 L * ? 每月最后一日的上午10:15觸發(fā)
• 0 15 10 ? * 6L 每月的最后一個星期五上午10:15觸發(fā)
• 0 15 10 ? * 6#3 每月的第三個星期五上午10:15觸發(fā)

@Scheduled 定時任務(wù)總結(jié)

@Scheduled

• 作用：spring定時器(定時執(zhí)行一次或定時輪詢執(zhí)行一段代碼)
• 使用場景：注解在方法上
• 參數(shù)說明：常用參數(shù)

@Scheduled 參數(shù)說明

• String cron:cron表達(dá)式定義了方法執(zhí)行的時間規(guī)則(網(wǎng)上對這個的說明很多就不墨跡了)

生成器工具地址-http://cron.qqe2.com/

• Long fixedDelay：定時任務(wù)每隔多久執(zhí)行一次，單位是毫秒，上一次任務(wù)結(jié)束后開始計算下次執(zhí)行的時間。

例子：@Scheduled(fixedDelay = 1000 * 10) //10秒發(fā)送一次

······················scheduled1開始執(zhí)行·······················2018-07-27 14:00:00

······················scheduled1結(jié)束執(zhí)行·······················2018-07-27 14:00:05

······················scheduled2開始執(zhí)行·······················2018-07-27 14:00:15

······················scheduled2結(jié)束執(zhí)行·······················2018-07-27 14:00:20

······················scheduled3開始執(zhí)行·······················2018-07-27 14:00:30

······················scheduled3結(jié)束執(zhí)行·······················2018-07-27 14:00:35

• Long fixedRate：與fixedDelay一樣表示定時任務(wù)的執(zhí)行時間間隔，不同的是fixedRate的不會受到上一次任務(wù)結(jié)束時間的影響

例子：@Scheduled(fixedRate = 1000 * 10) //10秒發(fā)送一次

······················scheduled1開始執(zhí)行·······················2018-07-27 14:00:00

······················scheduled1結(jié)束執(zhí)行·······················2018-07-27 14:00:05

······················scheduled2開始執(zhí)行·······················2018-07-27 14:00:10

······················scheduled2結(jié)束執(zhí)行·······················2018-07-27 14:00:15

······················scheduled3開始執(zhí)行·······················2018-07-27 14:00:20

······················scheduled3結(jié)束執(zhí)行·······················2018-07-27 14:00:25

• Long initialDelay：項目啟動后不馬上執(zhí)行定時器，根據(jù)initialDelay的值延時執(zhí)行。

注意事項

1.定時器的參數(shù)有兩種寫法是用cron表達(dá)式，或者使用fixedDelay、fixedRate等參數(shù)直接配置

需要注意的是 使用cron表達(dá)式的方法，在項目首次啟動后不會直接運行，而是等到執(zhí)行周期才會執(zhí)行

而使用第二種方式的定時器方法，在項目啟動成功后會馬上開始執(zhí)行一次，再按照時間周期執(zhí)行。

測試說明：

使用第一種配置方式，項目啟動后方法不會執(zhí)行，而是等到執(zhí)行周期到了才會執(zhí)行方法

使用第二種參數(shù)方式的方法，項目啟動成功后馬上執(zhí)行了一次

2.定時器默認(rèn)為單線程，所以如果項目中使用多個定時器要配置線程池

注意這里的@EnableScheduling，使用它來開啟定時器注解

@Configuration
@EnableScheduling
public class SchedulingConfig implements SchedulingConfigurer { 
	@Override
	public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
		taskRegistrar.setScheduler(taskExecutor());
	}
 
	@Bean(destroyMethod="shutdown")
    public Executor taskExecutor() {
        return Executors.newScheduledThreadPool(5 ,new ThreadFactory() {
        	private final AtomicLong counter = new AtomicLong();
			
			@Override
			public Thread newThread(Runnable r) {
				Thread thread = new Thread(r);
				thread.setName("test-scheduler-" + counter.incrementAndGet());
				return thread;
			}			
		});
    }	
}

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論