アノテーションインターフェース Scheduled
cron()
、fixedDelay()
、fixedRate()
のいずれかの属性を指定する必要があります。 アノテーション付きメソッドは引数を必要としません。通常、戻り値の型は void
になります。そうでない場合、スケジューラーを介して呼び出された場合、戻り値は無視されます。
@Scheduled
アノテーションの処理は、ScheduledAnnotationBeanPostProcessor
を登録することによって実行されます。これは、手動で実行することも、<task:annotation-driven/>
XML 要素または @EnableScheduling
アノテーションを介して実行する方が便利です。
このアノテーションは、繰り返し可能なSEアノテーションとして使用できます。
このアノテーションをメタアノテーションとして使用して、属性をオーバーライドしたカスタム合成アノテーションを作成できます。
- 導入:
- 3.0
- 作成者:
- Mark Fisher, Juergen Hoeller, Dave Syer, Chris Beams, Victor Brown, Sam Brannen
- 関連事項:
オプション要素のサマリー
修飾子と型オプションの要素説明cron のような表現で、通常の UN*X 定義を継承して、秒、分、時間、日、月、曜日のトリガーを含めます。long
最後の呼び出しの終了から次の呼び出しの開始までの期間を固定して、アノテーション付きメソッドを実行します。最後の呼び出しの終了から次の呼び出しの開始までの期間を固定して、アノテーション付きメソッドを実行します。long
呼び出しの間隔を固定して、アノテーション付きメソッドを実行します。呼び出しの間隔を固定して、アノテーション付きメソッドを実行します。long
fixedRate()
またはfixedDelay()
タスクの最初の実行までに遅延する時間の単位数。fixedRate()
またはfixedDelay()
タスクの最初の実行までに遅延する時間の単位数。cron 式が解決されるタイムゾーン。フィールドサマリー
フィールドの詳細
CRON_DISABLED
無効なトリガーを示す特別な cron 式値: "-"。これは、主に
${...}
プレースホルダーで使用するためのもので、対応するスケジュールされたメソッドを外部で無効にすることができます。- 導入:
- 5.1
- 関連事項:
要素の詳細
cron
StringSE croncron のような表現で、通常の UN*X 定義を継承して、秒、分、時間、日、月、曜日のトリガーを含めます。例:
"0 * * * * MON-FRI"
は、平日の 1 分間に 1 回(その分で -0 秒)を意味します。左から右に読み取られるフィールドは、次のように解釈されます。
- 秒
- 分
- 時間
- 月の日
- 月
- 曜日
特別な値
"-"
は、主に${...}
プレースホルダーによって解決される外部で指定された値を対象とした無効な cron トリガーを示します。- 戻り値:
- cron スケジュールに解析できる式
- 関連事項:
- デフォルト:
- ""
zone
StringSE zonecron 式が解決されるタイムゾーン。デフォルトでは、この属性は空の文字列です(つまり、サーバーのローカルタイムゾーンが使用されます)。- 戻り値:
TimeZone.getTimeZone(String)
SE が受け入れるゾーン ID、またはサーバーのデフォルトのタイムゾーンを示す空の文字列- 導入:
- 4.0
- 関連事項:
- デフォルト:
- ""
fixedDelay
long fixedDelay最後の呼び出しの終了から次の呼び出しの開始までの期間を固定して、アノテーション付きメソッドを実行します。時間の単位はデフォルトでミリ秒ですが、
timeUnit()
を介してオーバーライドできます。- 戻り値:
- 遅延
- デフォルト:
- -1L
fixedDelayString
StringSE fixedDelayString最後の呼び出しの終了から次の呼び出しの開始までの期間を固定して、アノテーション付きメソッドを実行します。時間の単位はデフォルトでミリ秒ですが、
timeUnit()
を介してオーバーライドできます。- 戻り値:
- 文字列値としての遅延 - たとえば、プレースホルダーまたは
java.time.Duration
SE 準拠の値 - 導入:
- 3.2.2
- デフォルト:
- ""
fixedRate
long fixedRate呼び出しの間隔を固定して、アノテーション付きメソッドを実行します。時間の単位はデフォルトでミリ秒ですが、
timeUnit()
を介してオーバーライドできます。- 戻り値:
- 期間
- デフォルト:
- -1L
fixedRateString
StringSE fixedRateString呼び出しの間隔を固定して、アノテーション付きメソッドを実行します。時間の単位はデフォルトでミリ秒ですが、
timeUnit()
を介してオーバーライドできます。- 戻り値:
- 文字列値としてのピリオド - たとえば、プレースホルダーまたは
java.time.Duration
SE 準拠の値 - 導入:
- 3.2.2
- デフォルト:
- ""
initialDelay
long initialDelay- 戻り値:
- 初期
- 導入:
- 3.2
- デフォルト:
- -1L
initialDelayString
StringSE initialDelayString- 戻り値:
- 文字列値としての初期遅延 - たとえば、プレースホルダーまたは
java.time.Duration
SE 準拠の値 - 導入:
- 3.2.2
- デフォルト:
- ""
timeUnit
TimeUnitSE timeUnitfixedDelay()
、fixedDelayString()
、fixedRate()
、fixedRateString()
、initialDelay()
、initialDelayString()
に使用するTimeUnit
SE。デフォルトは
TimeUnit.MILLISECONDS
SE です。この属性は、cron 式、
fixedDelayString()
、fixedRateString()
、initialDelayString()
を介して提供されるDuration
SE 値では無視されます。- 戻り値:
- 使用する
TimeUnit
- 導入:
- 5.3.10
- デフォルト:
- MILLISECONDS