Spring との違い
Spring にはアプリのナビゲーションがないため、このスターターは新しいものです。取り入れるものがある箇所では、Spring の名前とルールを借りています。このページでは、Spring から引き継いだものと、動作が異なる箇所を挙げます。
使う理由
Spring MVC や WebFlux を知っていれば、ルーターのほとんどは見慣れたものに見えます。クラスのパスパターン、ルートのビルダー、フィルター、スコープです。似ている範囲がどこで終わるかを知っておけば、驚きを避けられます。
例
両方で同じルートです。
// Spring WebFlux
RouterFunctions.route()
.GET("/books/{isbn}", handler::book)
.filter(adminOnly)
.build();
// ここ
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は使えません (トランジション を参照)。