
# ユーザーに従うウィジェット

いくつかのウィジェットと一つの Bean が、誰がログインしているかに従います。`context.principal` と `PrincipalBuilder` はログインとログアウトのたびに再ビルドされ、`PrincipalView` は、ロール、権限、SpEL 式に一致するユーザーにだけ子を表示します。これらは表示専用です。アクセスはサーバーがチェックします。

## 使う理由

アプリはユーザーの手の中にある (パッチを当てられ、API を直接呼ばれうる) ので、ボタンを隠しても何も保護されません。保護するのはサーバーのチェック (403) です。これらのウィジェットは、ページが何を描画するかを決めるだけの Thymeleaf の `sec:authorize` と同じく、失敗するボタンをユーザーに見せずに済ませるだけです。セキュリティではなくプリンシパル (誰がログインしているかを表す Spring の言葉) にちなんで名付けられているので、保護を約束しません。

## 例

```dart
// ユーザーに挨拶するか、ログインを提供するヘッダー。
PrincipalBuilder(
  builder: (context, authentication) => authentication == null
      ? const LoginButton()
      : Text('Hello, ${authentication.name}'),
)

// 管理者だけのための管理メニュー。
PrincipalView(
  hasRole: 'ADMIN',
  child: const AdminMenu(),
  otherwise: const SizedBox.shrink(),
)

// 任意のウィジェット: ユーザーが変わると再ビルドされる。
Text('Hello, ${context.principal?.name ?? 'guest'}');
```

## 部品

- **`PrincipalNotifier`**、Bean: `Listenable` としての現在の `Authentication` で、ログインとログアウトのたびに変わります。`SecurityContextHolder` (Spring Security の `ListeningSecurityContextHolderStrategy` を通して) と、`OAuth2LoginService` と `AuthenticationManager` の認証のイベントを聞きます。別のユーザーとして実行される作業 (`runWithContext`) は数えられず、匿名のユーザーは誰もいないとみなされます。
- **`context.principal`** は、任意のウィジェットの `build` の中でそれを読み、それが変わるとウィジェットを再ビルドします。
- **`PrincipalBuilder(builder:)`** は、現在の認証で組み立てます。誰もログインしていなければ `null` です。
- **`PrincipalView`** は、一致するプリンシパルには `child` を、そうでなければ `otherwise` (デフォルトは何もなし) を表示します。

| `PrincipalView` のパラメーター | 意味 |
|---|---|
| `hasRole` | ユーザーがこのロールを持つ (`ADMIN` は権限 `ROLE_ADMIN`) |
| `hasAuthority` | ユーザーがこの権限を持つ (`SCOPE_admin`) |
| `authenticated` | `true`: 誰かがログインしている。`false`: 誰もいない場合だけ |
| `expression` | `@PreAuthorize` と同じ SpEL 式: `"hasRole('ADMIN') or hasAuthority('SCOPE_admin')"` |
| `child` | 与えられたすべての条件が成り立つときに表示される |
| `otherwise` | それ以外のときに表示される。デフォルトは何もなし |

条件はアプリケーションの `MethodSecurityExpressionHandler` で評価されるので、ロールの階層が適用されます。

## Spring (Java) との対応

Spring にはウィジェットがありません。最も近いのは、サーバーのページが何を描画するかを決める Thymeleaf の `sec:authorize` と `sec:authentication` です。

## 関連項目

- [ガードされた画面](guarded-screens.md)
- [ログイン画面](login-screens.md)
- [spring_security_core](../spring-security-core/index.md)
