
# Spring との違い

`spring_web_dart` は Spring Web の名前と意味を保っています。マッピングのアノテーション、`ResponseEntity`、`HttpHeaders`、`HttpStatus`、`ProblemDetail`、`PathPattern` です。このページでは、Dart がそれらに別の形を与える箇所と、追加されたものを列挙します。

## 使う理由

Dart にはオーバーロードがなく、任意の位置引数と名前付き引数を混ぜられず、拡張型と null 安全性を持ち、ブラウザーで動きます。以下の違いはどれも、このいずれかから来ています。

## 例

```dart
@GetMapping.of(path: '/books', produces: MediaType.applicationJson)
Future<List<Book>> search(@RequestParam('page') int page = 0);
```

```java
@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)。

## 関連項目

- [概要](index.md)
- [マッピングのアノテーション](mapping-annotations.md)
- [HTTP の型](http-types.md)
