
# Spring との違い

Spring にはアプリのナビゲーションがないため、このスターターは新しいものです。取り入れるものがある箇所では、Spring の名前とルールを借りています。このページでは、Spring から引き継いだものと、動作が異なる箇所を挙げます。

## 使う理由

Spring MVC や WebFlux を知っていれば、ルーターのほとんどは見慣れたものに見えます。クラスのパスパターン、ルートのビルダー、フィルター、スコープです。似ている範囲がどこで終わるかを知っておけば、驚きを避けられます。

## 例

両方で同じルートです。

```java
// Spring WebFlux
RouterFunctions.route()
    .GET("/books/{isbn}", handler::book)
    .filter(adminOnly)
    .build();
```

```dart
// ここ
ScreenRoutes.route()
    .screen('/books/{isbn}', (r) => const BookPage())
    .filter(AdminOnly())
    .build();
```

## 引き継いだもの

| Spring | ここ |
|---|---|
| `@GetMapping("/books/{isbn}")` のパスパターン: `{name}`、`{name:regex}`、`{*rest}` | `@ScreenRoute` での同じ構文 |
| `RouterFunctions.route()...build()` | `ScreenRoutes.route()...build()` |
| `HandlerFilterFunction` | `RouteFilter` |
| `request` と `session` のスコープ | `route` と `branch` のスコープ |
| メソッドの `@PreAuthorize` | 画面の `@PreAuthorize` (セキュリティスターターがある場合) |
| `RestTemplate`、`JdbcTemplate` | ナビゲーションの API である `RouteTemplate` |
| springdoc の `@Operation` | `@RouteInfo` |

## 異なる点

- **ルートはハンドラーではなくウィジェットを開きます。** 応答はなく、画面は `context.route` から値を読みます。
- **クエリパラメーターは型とともに宣言され** (`params: {'page': int}`)、画面が開く前に変換されます。変換できない値は、`400` に相当するエラー画面を表示します。
- **追加のオブジェクト**には HTTP での対応物がありません。メモリ上で渡され、再読み込みやディープリンクでは失われます。
- **シェル**はブランチごとにスタックを持ちます。これはどのサーバーにもありません。
- **同じルートの別のアドレスは画面を保ちます。** その状態とスクロールも保たれます。
- **ガードはセキュリティではありません。** デバイス上の画面を隠すだけで、サーバーは引き続きすべてのリクエストをチェックしなければなりません。
- **ディープリンク**はビルド時にプラットフォームのファイルに書き込まれます。

## 制限

- Windows と Linux にはまだディープリンクがありません。
- パス変数を持つ画面は、`@RouteInfo(paths: [...])` がそのアドレスを列挙しない限り、検索エンジンのためのページを得ません。
- `SpringApplicationWidget` はテストで Bean のオーバーライドを受け取りません。
- ルーターはデザインライブラリーを知りません。デザインのスターターがなければ、`platform` にトランジションはなく、`zoom` と `cupertino` は使えません ([トランジション](transitions.md#デザインライブラリーのトランジション) を参照)。

## 関連項目

- [概要](index.md)
- [spring_boot_starter_flutter の違い](../spring-boot-starter-flutter/differences.md)
