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> で、再接続が組み込まれている

まだ対応していないもの

関連項目