
# Spring との違い

`spring_boot_starter_scheduling` は、Spring の `@Scheduled`、`TaskScheduler`、トリガー、cron の構文に従っています。このページでは、そうでない箇所とその理由を列挙します。

## 使う理由

違いは Dart から来ています。スレッドプールではなく一つのイベントループ、タイムゾーンデータベースがないこと、オーバーロードがないこと、`Future`、そして JavaScript では 25 日待てないタイマーです。

## 例

```dart
@Scheduled(fixedRate: Duration(minutes: 5))
Future<void> refresh() => cache.refresh(); // 次の実行の前に待たれる
```

```java
@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 以外のタイムゾーン。

## 関連項目

- [概要](index.md)
- [すべてのプロパティ](properties.md)
- [@Scheduled](scheduled.md)
