Spring との違い
spring_boot_starter_scheduling は、Spring の @Scheduled、TaskScheduler、トリガー、cron の構文に従っています。このページでは、そうでない箇所とその理由を列挙します。
使う理由
違いは Dart から来ています。スレッドプールではなく一つのイベントループ、タイムゾーンデータベースがないこと、オーバーロードがないこと、Future、そして JavaScript では 25 日待てないタイマーです。
例
@Scheduled(fixedRate: Duration(minutes: 5))
Future<void> refresh() => cache.refresh(); // 次の実行の前に待たれる
@Scheduled(fixedRate = 5, timeUnit = TimeUnit.MINUTES)
CompletableFuture<Void> refresh() { ... } // 待たれない
違い
| Spring | ここでは | 理由 |
|---|---|---|
@EnableScheduling |
不要。spring.task.scheduling.enabled=false で無効になる |
スターターだけで足りる。 |
zone に任意のタイムゾーン |
ローカル時刻か UTC のみ | Dart にはタイムゾーンデータベースがない。 |
数値と timeUnit |
Duration |
|
schedule(task, Instant) |
scheduleAt(task, DateTime) |
オーバーロードがない。 |
ScheduledFuture |
ScheduledTask |
|
実時間の時計で計画される PeriodicTrigger |
scheduleAtFixedRate / scheduleWithFixedDelay と同じく、タスク自身のタイムラインで実行する |
実時間の時計の変更は何も動かさない。 |
遅延全体を待つ cron や scheduleAt の待機 |
最大 1 日のタイマー。待機は実時間の時計がその時刻を過ぎてから 1 日以内に終わる | JavaScript のタイマーは 25 日待てない。 |
返された CompletableFuture は待たれない。リアクティブな結果は fixedDelay でだけ待たれる |
返された Future はどの種類でも待たれるため、遅い実行は次の実行と重なるのではなく、それを遅らせる |
一つのイベントループ。 |
曜日の #k は、決して一致しない大きな序数も受け入れる |
#k は 1-5 を受け取る |
|
プライマリーのない複数の TaskScheduler の Bean: ローカルのシングルスレッドのスケジューラー |
起動が失敗する | 明示的に。 |
close() での await-termination |
closeAsync() でのみ。実行中のものが中断されることは決してない |
Dart は同期的な呼び出しの中で待てない。 |
@EnableAsync による任意の Bean のメソッドの @Async |
@EventListener メソッドのみ。TaskExecutor の Bean が有効にする |
|
spring.task.scheduling.pool.*、spring.task.execution.* |
読まれない | スレッドがない。 |
スケジューラーに設定する ErrorHandler |
型で見つけられる ErrorHandler の Bean |
まだ対応していないもの
SchedulingConfigurerとScheduledTaskRegistrar。- プロトタイプの Bean のスケジューリング (警告とともに無視されます)。
- ローカルと UTC 以外のタイムゾーン。