Spring との違い
spring_web_dart は Spring Web の名前と意味を保っています。マッピングのアノテーション、ResponseEntity、HttpHeaders、HttpStatus、ProblemDetail、PathPattern です。このページでは、Dart がそれらに別の形を与える箇所と、追加されたものを列挙します。
使う理由
Dart にはオーバーロードがなく、任意の位置引数と名前付き引数を混ぜられず、拡張型と null 安全性を持ち、ブラウザーで動きます。以下の違いはどれも、このいずれかから来ています。
例
@GetMapping.of(path: '/books', produces: MediaType.applicationJson)
Future<List<Book>> search(@RequestParam('page') int page = 0);
@GetMapping(value = "/books", produces = MediaType.APPLICATION_JSON_VALUE)
List<Book> search(@RequestParam(name = "page", defaultValue = "0") int page);
アノテーション
| Spring |
ここでは |
理由 |
@GetMapping("/books", produces = ...) |
@GetMapping.of(path: '/books', produces: ...)。@GetMapping() と @GetMapping('/books') はそのまま |
名前付き引数の隣に任意の位置引数を置けない。 |
配列としての produces と consumes |
カンマ区切りの一つの String |
|
required、defaultValue |
Dart のパラメーター: nullable は任意、デフォルトはデフォルト、それ以外は必須 |
null 安全性がそれを示す。 |
クライアントでのマッピングの headers (OpenFeign) |
'Name=value' は送られる。条件 ('Name'、'!Name'、'Name!=value') は無視される。Feign の 'Name: value' は起動時に拒否される |
|
@ExceptionHandler はサブタイプにも一致する |
types は実行時の型の完全一致で照合される |
Type の間で実行時にサブタイプを調べられない。 |
型
| Spring |
ここでは |
name() を持つ HttpStatus の列挙型 |
int の定数 (拡張型)。toString() は数値。100 Continue は HttpStatus.continue_。非推奨の別名 (PAYLOAD_TOO_LARGE、UNPROCESSABLE_ENTITY) は除かれている。レスポンスの statusCode は、これも int である HttpStatusCode。 |
HttpHeaders.CONTENT_TYPE |
HttpHeaders.contentTypeHeader (dart:io と同じく、単なる名前は型付きのアクセサー)。 |
MediaType の contentType、ないときは -1 の lastModified、空の contentDisposition |
String の contentType、List<MediaType> の accept、DateTime? の lastModified と date、ないときは null の contentDisposition。 |
addAll(HttpHeaders)、putAll(HttpHeaders) |
addHeaders(other)、putAll(other)。addAll(name, values) は一つの名前の値を追加する。size は名前を数える。operator [] は最初の値を、getAll はすべてを返す。toMap() は値を , でつなぎ、toSingleValueMap() は最初のものを保つ。 |
MediaType のオブジェクトと ..._VALUE の文字列 |
定数は文字列 (アノテーションで使える)。MediaType.parse はオブジェクトを返す。Dart の知らない charset はエラーではなく null になり、bodyText は UTF-8 にフォールバックする。 |
ResponseEntity.ok() のビルダー、of(Optional) |
ResponseEntity.ok(body) はコンストラクター。ビルダーは ResponseEntity.status(HttpStatus.ok)。of は nullable なボディを受け取る。== はボディの中のコレクションを内容で比較する。 |
HttpMethod.valueOf("get") はメソッドを作る |
HttpMethod.parse は大文字小文字を区別し、それ以外のテキストでは例外を投げる。 |
クライアントとサーバー
| Spring |
ここでは |
| 読み取りタイムアウト |
readTimeout (同じもの) と、やり取り全体の期限である timeout |
| リクエストの全処理に上限はない |
Zone に載せられ、Web と Feign のスターターが守る RequestDeadline |
WebSocketHandler のコールバック。TextMessage、BinaryMessage。ブロックする sendMessage |
Stream としての messages。sendMessage(String) またはバイト。ブロックせず、dart:io では flush() がある。セッションの closeStatus |
| Tomcat のクライアントはハンドシェイクのリダイレクトをたどる |
ブラウザーと同じく、たどらない |
任意の長さのオリジンを受け付ける AllowedOrigins (CorsConfiguration の中) |
1024 文字を超えるオリジンは決して許可されない |
EventStream はない。Flux<ServerSentEvent<T>> |
EventStream<T> は .events を持つ Stream<T> で、再接続が組み込まれている |
まだ対応していないもの
RestClient 風の流れるようなクライアント (Feign のインターフェースと HttpTransport がその用途をカバーします)。
- WebSocket の圧縮拡張 (permessage-deflate)。
関連項目