
# @Async とエラー

スターターは Spring Boot の `applicationTaskExecutor` の Bean (別名 `taskExecutor`) を登録します。これは `@EventListener` メソッドの `@Async` を有効にします。そうしたリスナーは、イベントを発行した呼び出しの中ではなく、後で実行されます。スケジュールされた実行のエラーはログに出され、`ErrorHandler` の Bean がそれを受け取らない限り、タスクはスケジュールを保ちます。

## 使う理由

イベントへの反応の中には、それを発行したコードを遅くすべきでないものがあります。注文の後の確認メールの送信、監査のエントリーの書き込みなどです。そして、一度失敗した (サーバーが一時的にダウンした) スケジュールされたタスクは、永久に止まるべきでも、黙って失敗すべきでもありません。

## 例

```dart
@Component()
class Mailer {
  // 発行者がメールを待たずに注文は確定する。
  @EventListener()
  @Async() // 別の TaskExecutor の Bean には @Async('mailExecutor')
  Future<void> onPlaced(OrderPlaced order) => sendConfirmation(order);
}

// 失敗したすべての実行が報告され、タスクは実行され続ける。
@Component()
class ReportErrors implements ErrorHandler {
  @override
  void handleError(Object error, StackTrace stackTrace) =>
      crashReporter.record(error, stackTrace);
}
```

## TaskExecutor

- `applicationTaskExecutor` の Bean は、コアの `SimpleAsyncTaskExecutor` です。各タスクをイベントループの後のターンで実行し、そのエラーをログに出します。
- 独自の `TaskExecutor` の Bean を宣言すると、それを置き換えます。
- エクゼキューターがあると、Spring の `@EnableAsync` と同じく、`@EventListener` メソッドの `@Async` が有効になります。`@Async('name')` は別の `TaskExecutor` の Bean を選びます。
- `@Async` は `@EventListener` メソッドでだけ動きます。
- スレッドプールはありません。すべては Dart のイベントループで実行されます。`spring.task.execution.*` は読まれません。

リスナー側については [@Async](../spring-core-dart/events/async.md) を参照してください。

## スケジュールされた実行のエラー

実行の例外 (投げられたもの、または返された `Future` からのもの) は、タスクの名前とともに `spring.scheduling` ロガーに error レベルでログに出され、タスクはスケジュールを保ちます。リトライやアラートが必要ならメソッドの中でエラーを処理するか、`ErrorHandler` の Bean を宣言してください。その場合、ログの代わりにそれがすべてのエラーを受け取ります。

- スケジューラーは、唯一の `ErrorHandler` の Bean、またはプライマリーのものを使います。複数あってプライマリーがなければ、どれも使いません。
- 例外を投げるハンドラーはタスクを止めます。Spring の `LOG_AND_PROPAGATE` と同じく、エラーはログに出され、タスクは再び実行されません。
- `TimerTaskScheduler(errorHandler:)` はコードでそれを設定します。

## Spring (Java) との対応

```java
@EnableAsync
@Configuration
class AsyncConfig {}

@Async
@EventListener
public void onPlaced(OrderPlaced order) { ... }
```

`@EnableAsync` はありません。`TaskExecutor` の Bean がそれを有効にします。他の Bean のメソッドの `@Async` には対応していません。Spring は `ErrorHandler` をその `ThreadPoolTaskScheduler` に設定します。ここでは Bean が型で見つけられます。

## 関連項目

- [イベント](../spring-core-dart/events/index.md)
- [@Scheduled](scheduled.md)
- [TaskScheduler](task-scheduler.md)
