在 Spring Framework 的開(kāi)發(fā)中，@Scheduled 注解是我們實(shí)現(xiàn)定時(shí)任務(wù)的利器。其中，fixedRateString 屬性允許我們通過(guò)字符串來(lái)配置任務(wù)執(zhí)行的固定速率。從 Spring 5 開(kāi)始，為了更好地支持 Java 8 的日期時(shí)間 API，fixedRateString（以及 fixedDelayString, initialDelayString）開(kāi)始支持 java.time.Duration 的格式進(jìn)行解析。

這為我們提供了比毫秒數(shù)字更優(yōu)雅、更易讀的配置方式。今天，我們就來(lái)深入探討一下這個(gè)強(qiáng)大的功能。

從毫秒到 Duration：為何要改變？

在舊版本中，我們通常這樣配置：

@Scheduled(fixedRate = 5000) // 每5秒執(zhí)行一次
public void doTask() {
    // 任務(wù)邏輯
}

或者使用字符串形式（為了支持占位符）：

@Scheduled(fixedRateString = "5000") // 從配置文件中讀取，例如：scheduled.rate=5000
public void doTask() {
    // 任務(wù)邏輯
}

這種方式雖然直接，但可讀性較差。看到 5000，你需要反應(yīng)一下才知道是 5 秒。而 Duration 格式則一目了然：

@Scheduled(fixedRateString = "PT5S") // 清晰明了：Period of Time 5 Seconds
public void doTask() {
    // 任務(wù)邏輯
}

核心：java.time.Duration.parse 支持的格式

Spring 底層使用 java.time.Duration.parse(CharSequence) 方法來(lái)解析 fixedRateString 的值。該方法遵循 ISO-8601 持續(xù)時(shí)間格式。

其正則表達(dá)式定義如下： ([-+]?)P(?:([-+]?[0-9]+)D)?(T(?:([-+]?[0-9]+)H)?(?:([-+]?[0-9]+)M)?(?:([-+]?[0-9]+)(?:[.,]([0-9]{0,9}))?S)?)?

看起來(lái)復(fù)雜，但其結(jié)構(gòu)非常清晰，可以分解為：

基本結(jié)構(gòu)： P[n]Y[n]M[n]W[n]D[T[n]H[n]M[n]S]]

• P (必需): 是“Period”的縮寫(xiě)，表示持續(xù)時(shí)間段的開(kāi)始。
• T (可選): 是“Time”的縮寫(xiě)，用于分隔日期部分和時(shí)間部分。如果要指定小時(shí)、分鐘或秒，則必須有 T。

日期部分 (在 P 之后，T 之前)：

• Y - 年
• M - 月
• W - 周
• D - 天

時(shí)間部分 (在 T 之后)：

• H - 小時(shí)
• M - 分鐘
• S - 秒 (可以包含小數(shù)，使用 . 或 , 分隔，例如 PT30.5S 是 30.5 秒)

重要提示： 對(duì)于 Duration 類(lèi)型，它主要用于衡量精確的時(shí)間段，而不是用于基于日歷的、不精確的時(shí)間段。因此，在解析時(shí)，年（Y） 和 月（M） 會(huì)被忽略（一個(gè)月的天數(shù)不固定，無(wú)法精確轉(zhuǎn)換為 Duration）。周（W） 和 天（D） 則會(huì)被正常轉(zhuǎn)換（1天=24小時(shí)，1周=7天）。

這意味著，雖然格式允許 Y 和 M，但在 Duration 的語(yǔ)境下，它們是沒(méi)有意義的。你應(yīng)該專(zhuān)注于使用 D, H, M, S。

實(shí)戰(zhàn)示例

讓我們看一些在 @Scheduled 中有效的配置示例：

1. 5 秒: PT5S
2. 30 分鐘: PT30M 或 PT1800S
3. 2 小時(shí): PT2H
4. 2 小時(shí) 30 分鐘: PT2H30M
5. 1 天: P1D (相當(dāng)于 PT24H)
6. 1 天 6 小時(shí): P1DT6H
7. 1.5 秒 (1500毫秒): PT1.5S
8. 從配置文件讀取:
   • application.properties:

     my.task.rate=PT10S
     my.task.delay=P1DT12H
     

   • Java Code:

     @Scheduled(fixedRateString = "${my.task.rate}", initialDelayString = "${my.task.delay}")
     public void doScheduledTask() {
         // 應(yīng)用啟動(dòng)后，先延遲 1天半 (36小時(shí))，然后每10秒執(zhí)行一次
     }
     

常見(jiàn)錯(cuò)誤與陷阱

1. 忘記 T 分隔符：

   • 錯(cuò)誤: P1H30M (試圖在日期部分指定小時(shí))
   • 正確: PT1H30M (必須用 T 引入時(shí)間部分)

2. 使用 Y 或 M：

   • 無(wú)效: P1M (期望是1個(gè)月，但實(shí)際會(huì)被解析為 0)
   • 無(wú)效: P1Y1M (年份和月份都會(huì)被忽略，解析結(jié)果也是 0)
   • 如果需要“大約一個(gè)月”這種基于日歷的概念，Duration 不是正確的工具，應(yīng)考慮 Cron 表達(dá)式。

3. 負(fù)值： 格式支持負(fù)值（-PT5S），但這在調(diào)度場(chǎng)景中沒(méi)有意義，會(huì)導(dǎo)致異常。

總結(jié)

將 java.time.Duration 的 ISO-8601 格式與 Spring 的 @Scheduled 注解結(jié)合使用，極大地提升了配置的可讀性和可維護(hù)性。

記住這個(gè)口訣：先寫(xiě) P，要時(shí)間再加 T，忽略 Y 和 M，D/H/M/S 放心用。

到此這篇關(guān)于Spring定時(shí)任務(wù)之fixedRateString的實(shí)現(xiàn)示例的文章就介紹到這了,更多相關(guān)Spring定時(shí)任務(wù)fixedRateString內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論