public interface TaskScheduler
Runnables
のスケジューリングを抽象化するタスクスケジューラインターフェース。 このインターフェースは、通常、異なる種類のバックエンド、つまり異なる特性と機能を持つスレッドプールを表すため、SchedulingTaskExecutor
とは別のものです。実装は、両方の種類の実行特性を処理できる場合、両方のインターフェースを実装できます。
'default' 実装は ThreadPoolTaskScheduler
であり、ネイティブ ScheduledExecutorService
をラップし、拡張トリガー機能を追加します。
このインターフェースは、Java EE 7 環境でサポートされている JSR-236 ManagedScheduledExecutorService
とほぼ同等ですが、Spring の TaskExecutor
モデルと整合しています。
TaskExecutor
, ScheduledExecutorService
, ThreadPoolTaskScheduler
修飾子と型 | メソッドと説明 |
---|---|
java.util.concurrent.ScheduledFuture<?> | schedule(java.lang.Runnable task, java.util.Date startTime) 指定された Runnable をスケジュールし、指定された実行時間に起動します。 |
default java.util.concurrent.ScheduledFuture<?> | schedule(java.lang.Runnable task, java.time.Instant startTime) 指定された Runnable をスケジュールし、指定された実行時間に起動します。 |
java.util.concurrent.ScheduledFuture<?> | schedule(java.lang.Runnable task, Trigger trigger) 指定された Runnable をスケジュールし、トリガーが次の実行時間を示したときに起動します。 |
java.util.concurrent.ScheduledFuture<?> | scheduleAtFixedRate(java.lang.Runnable task, java.util.Date startTime, long period) 指定された Runnable をスケジュールして、指定された実行時間に起動し、その後、指定された期間で起動します。 |
default java.util.concurrent.ScheduledFuture<?> | scheduleAtFixedRate(java.lang.Runnable task, java.time.Duration period) 指定された Runnable をスケジュールします。できるだけ早く開始し、指定された期間で起動します。 |
default java.util.concurrent.ScheduledFuture<?> | scheduleAtFixedRate(java.lang.Runnable task, java.time.Instant startTime, java.time.Duration period) 指定された Runnable をスケジュールして、指定された実行時間に起動し、その後、指定された期間で起動します。 |
java.util.concurrent.ScheduledFuture<?> | scheduleAtFixedRate(java.lang.Runnable task, long period) 指定された Runnable をスケジュールします。できるだけ早く開始し、指定された期間で起動します。 |
java.util.concurrent.ScheduledFuture<?> | scheduleWithFixedDelay(java.lang.Runnable task, java.util.Date startTime, long delay) 指定された Runnable をスケジュールして、指定された実行時間に起動し、その後、ある実行の補完から次の実行の開始までの間に指定された遅延を設定します。 |
default java.util.concurrent.ScheduledFuture<?> | scheduleWithFixedDelay(java.lang.Runnable task, java.time.Duration delay) 指定された Runnable をスケジュールして、できるだけ早く開始し、1 つの実行の補完から次の実行の開始までの間に指定された遅延を指定して呼び出します。 |
default java.util.concurrent.ScheduledFuture<?> | scheduleWithFixedDelay(java.lang.Runnable task, java.time.Instant startTime, java.time.Duration delay) 指定された Runnable をスケジュールして、指定された実行時間に起動し、その後、ある実行の補完から次の実行の開始までの間に指定された遅延を設定します。 |
java.util.concurrent.ScheduledFuture<?> | scheduleWithFixedDelay(java.lang.Runnable task, long delay) 指定された Runnable をスケジュールして、できるだけ早く開始し、1 つの実行の補完から次の実行の開始までの間に指定された遅延を指定して呼び出します。 |
@Nullable java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable task, Trigger trigger)
Runnable
をスケジュールし、トリガーが次の実行時間を示したときに起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する Runnabletrigger
- Trigger
インターフェースの実装。cron 式をラップする CronTrigger
オブジェクト ScheduledFuture
、または指定された Trigger オブジェクトが起動しない場合は null
(つまり、Trigger.nextExecutionTime(org.springframework.scheduling.TriggerContext)
から null
を返します)TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)CronTrigger
default java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable task, java.time.Instant startTime)
Runnable
をスケジュールし、指定された実行時間に起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する RunnablestartTime
- タスクの望ましい実行時間 (これが過去の場合、タスクはすぐに、つまりできるだけ早く実行されます)ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)schedule(Runnable, Date)
java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable task, java.util.Date startTime)
Runnable
をスケジュールし、指定された実行時間に起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する RunnablestartTime
- タスクの望ましい実行時間 (これが過去の場合、タスクはすぐに、つまりできるだけ早く実行されます)ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)default java.util.concurrent.ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable task, java.time.Instant startTime, java.time.Duration period)
Runnable
をスケジュールして、指定された実行時間に起動し、その後、指定された期間で起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する RunnablestartTime
- タスクに必要な最初の実行時間 (これが過去の場合、タスクはすぐに、つまりできるだけ早く実行されます)period
- タスクの連続した実行の間隔 ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)scheduleAtFixedRate(Runnable, Date, long)
java.util.concurrent.ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable task, java.util.Date startTime, long period)
Runnable
をスケジュールして、指定された実行時間に起動し、その後、指定された期間で起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する RunnablestartTime
- タスクに必要な最初の実行時間 (これが過去の場合、タスクはすぐに、つまりできるだけ早く実行されます)period
- タスクの連続した実行の間隔 (ミリ秒単位)ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)default java.util.concurrent.ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable task, java.time.Duration period)
Runnable
をスケジュールします。できるだけ早く開始し、指定された期間で起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する Runnableperiod
- タスクの連続した実行の間隔 ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)scheduleAtFixedRate(Runnable, long)
java.util.concurrent.ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable task, long period)
Runnable
をスケジュールします。できるだけ早く開始し、指定された期間で起動します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する Runnableperiod
- タスクの連続した実行の間隔 (ミリ秒単位)ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)default java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable task, java.time.Instant startTime, java.time.Duration delay)
Runnable
をスケジュールして、指定された実行時間に起動し、その後、ある実行の補完から次の実行の開始までの間に指定された遅延を設定します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する RunnablestartTime
- タスクに必要な最初の実行時間 (これが過去の場合、タスクはすぐに、つまりできるだけ早く実行されます)delay
- ある実行の補完から次の実行の開始までの遅延 ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)scheduleWithFixedDelay(Runnable, Date, long)
java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable task, java.util.Date startTime, long delay)
Runnable
をスケジュールして、指定された実行時間に起動し、その後、ある実行の補完から次の実行の開始までの間に指定された遅延を設定します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する RunnablestartTime
- タスクに必要な最初の実行時間 (これが過去の場合、タスクはすぐに、つまりできるだけ早く実行されます)delay
- ある実行の補完から次の実行の開始までの遅延 (ミリ秒単位)ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)default java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable task, java.time.Duration delay)
Runnable
をスケジュールして、できるだけ早く開始し、1 つの実行の補完から次の実行の開始までの間に指定された遅延を指定して呼び出します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する Runnabledelay
- ある実行の補完から次の実行の開始までの遅延 ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)scheduleWithFixedDelay(Runnable, long)
java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable task, long delay)
Runnable
をスケジュールして、できるだけ早く開始し、1 つの実行の補完から次の実行の開始までの間に指定された遅延を指定して呼び出します。 スケジューラーがシャットダウンするか、返された ScheduledFuture
がキャンセルされると、実行が終了します。
task
- トリガーが起動するたびに実行する Runnabledelay
- ある実行の補完から次の実行の開始までの遅延 (ミリ秒単位)ScheduledFuture
TaskRejectedException
- 特定のタスクが内部的な理由で受け入れられなかった場合 (たとえばプールのオーバーロード処理ポリシーまたは進行中のプールのシャットダウン)