Spring Scheduling

Annotation

• @Scheduled : Spring で定時(ていじ) タスクを作成(さくせい) するために使用(しよう) します。
  • 属性(ぞくせい) (fields) :
    • cron : Cron 式(しき) を使用(しよう) して実行(じっこう) 頻度(ひんど) を定義(ていぎ) 。
    • fixedDelay : 前回(ぜんかい) のタスク終了(しゅうりょう) から次回(じかい) のタスク開始(かいし) までの固定(こてい) 遅延(ちえん) 。パラメータ: long (ms)
    • fixedDelayString : fixedDelay と同(おな) じですが、文字列(もじれつ) や ${...} 設定(せってい) をサポート。
    • fixedRate : 二(ふた) つのタスク開始(かいし) 間(かん) の固定(こてい) 頻度(ひんど) 。前回(ぜんかい) のタスク完了(かんりょう) を待(ま) たない。
    • fixedRateString : 同上(どうじょう) 、文字列(もじれつ) 設定(せってい) 。
    • initialDelay : 最初(さいしょ) のタスク実行前(じっこうまえ) の遅延(ちえん) 時間(じかん) 。
    • initialDelayString : 同上(どうじょう) 、文字列(もじれつ) 設定(せってい) 。
    • timeUnit : 時間(じかん) 単位(たんい) を指定(してい) 、デフォルトは ms (ミリ秒(びょう) )。
    • zone : タイムゾーン (Timezone) を指定(してい) 。

Cron 構文(こうぶん) 例(れい)

• 0 0 0 * * ? : 毎日(まいにち) 午前(ごぜん) 0時(じ) に実行(じっこう) 。
• 0 0/5 * * * ? : 5分(ふん) ごとに実行(じっこう) 。
• 0 0 12 ? * MON-FRI : 平日(へいじつ) の正午(しょうご) 12時(じ) 。

ベストプラクティス

1. 非同期(ひどうき) 実行(じっこう) : デフォルトでは、@Scheduled は単一(たんいつ) スレッドで実行(じっこう) されます。複数(ふくすう) のタスクがある場合(ばあい) は、TaskScheduler を設定(せってい) するか @Async を使用(しよう) してください。
2. 外部化(がいぶか) 設定(せってい) : Cron 式(しき) を ${property.name} 構文(こうぶん) で application.yml に抽出(ちゅうしゅつ) することを推奨(すいしょう) します。
3. 例外(れいがい) 処理(しょり) : 定時(ていじ) タスク内(ない) の例外(れいがい) がキャッチされない場合(ばあい) 、後続(こうぞく) の実行(じっこう) が中断(ちゅうだん) される可能性(かのうせい) があります。