
# 画面やブランチごとの Bean

二つの Bean のスコープがナビゲーションに従います。`route` の Bean は、その画面が開くときに作られ、閉じるときに、その退場アニメーションの後で破棄されます。`branch` の Bean は、そのブランチを初めて訪れたときに作られ、シェルが閉じるとき (タブを離れる、ログアウト) に破棄されます。

## 使う理由

フォームの状態はその画面に属します。画面が開くたびに新しく、閉じると消えるべきです。タブの状態 (検索、フィルター) はタブに属します。シングルトンにすると訪問から次の訪問へ漏れ、`State` のフィールドにするとサービスと共有できません。スコープ付きの Bean はその両方を満たします。他の Bean と同じく注入され、画面やタブと同じだけ短命です。

## 例

```dart
// 本の編集画面が開くたびに新しいフォーム。
@ChangeNotifierComponent()
@Scope(NavigationScopes.route)
class BookForm {
  String title = '';
  void rename(String value) => title = value;
}

// カタログタブの検索。ユーザーがタブを切り替えても保たれる。
@ChangeNotifierComponent()
@Scope(NavigationScopes.branch)
class CatalogSearch {
  String query = '';
  void search(String value) => query = value;
}
```

```dart
@ScreenRoute('/catalog/books/{isbn}/edit')
class EditBookPage extends SpringStatelessWidget<(BookForm,)> {
  const EditBookPage({super.key});

  @override
  Widget build(BuildContext context) {
    final (form,) = beans; // この画面自身のフォーム
    return TextField(onChanged: form.rename);
  }
}
```

## スコープ

| スコープ | 作られる時 | 破棄される時 |
|---|---|---|
| `NavigationScopes.route` (`'route'`) | その画面が開くとき | 画面が閉じるとき、その退場アニメーションの後 |
| `NavigationScopes.branch` (`'branch'`) | そのブランチを初めて訪れたとき | シェルが閉じるとき |

ウィジェットからの検索は、そのウィジェットの画面とブランチの Bean を受け取ります。スタック上の同じルートの二つの画面は、それぞれ独自のものを持ちます。それ以外の検索 (シングルトン、サービス) は、一番上の画面のものを受け取ります。スターターは、すべての画面の周りの `BeanLookupScope` でこれを行います。

## Spring (Java) との対応

Spring Web には `request` と `session` のスコープがあります。これらは画面とタブについての同じ考え方です。

## 関連項目

- [ウィジェットの中の Bean](../spring-boot-starter-flutter/beans-in-widgets.md)
- [シェルとタブ](shells.md)
- [spring_core_dart のスコープ](../spring-core-dart/beans/index.md)
