: (data) => List.from(data).map((json) => User.fromJson(json)).toList(),
User: (data) => User.fromJson(data),
// ...
};
```
В файле modelDecoders нужно указать `Type` в качестве ключа и обработать преобразование в значении, как в примере выше.
Аргумент `data` будет содержать данные из ответа API-запроса.
## Типизированные декодеры
Требуется
Nylo 7.5.0+
nylo_support 7.37.0+
`decoders([...])` строит вашу карту `modelDecoders` из списка. `Decode(User.fromJson)` декодирует `User`, а также `List`, без отдельной записи:
```dart
final Map modelDecoders = decoders([
Decode(User.fromJson),
Decode(Order.fromJson, from: 'data'),
]);
```
Используйте `from`, чтобы прочитать модель изнутри обёрнутого тела, например `{"data": {...}}`. Ключ с точками, такой как `'data.user'`, читает глубже, а для списка сам список читается из `from`.
`Decode` принимает `fromJson`, который принимает `dynamic` или `Map`. Для замыкания укажите тип его параметра:
```dart
Decode((dynamic json) => User.fromJson(json)),
```
Декодеры-замыкания в карте `{...}`, например `User: (data) => User.fromJson(data)`, продолжают работать. Оба являются `NyDecoder` -- классом, который расширяют `Decode` и `OneOf`. Собственный `NyDecoder` реализует `decode(json, response, decoders)` и видит весь `NyResponse`, поэтому может читать код состояния или заголовки.
## OneOf
Требуется
Nylo 7.5.0+
nylo_support 7.37.0+
`OneOf` декодирует ответ, который может иметь несколько форм. Зарегистрируйте его под общим родительским типом и выбирайте форму по полю в теле, по коду состояния или с помощью собственных условий:
```dart
final Map modelDecoders = decoders([
OneOf.byKey('status', {
'success': LoginSuccess.fromJson,
'two_factor': TwoFactorRequired.fromJson,
}, otherwise: (json) => LoginFailed(ApiError.fromJson(json))),
]);
```
`OneOf` также декодирует тела ответов 4xx и 5xx, а `List` -- элемент за элементом. Если форма не распознана, данные ответа остаются null.
| Конструктор | Выбирает форму по |
|-------------|--------------------|
| `OneOf.byKey(key, types, otherwise:)` | Значению `key` в теле. Ключ с точками, такой как `'data.type'`, читает вложенное поле |
| `OneOf.byStatus(types, otherwise:)` | Коду состояния. Ключ -- это код, например `404`, или шаблон, например `'4xx'` или `'40x'` |
| `OneOf.byJson(types, otherwise:)` | Вашим собственным условиям, каждое принимает тело и ответ. Побеждает первое, вернувшее true |
| `OneOf(resolve)` | Функции, которая принимает тело и ответ и возвращает значение или null |
По коду состояния:
```dart
OneOf.byStatus({
200: OrderPlaced.fromJson,
404: OrderNotFound.fromJson,
'4xx': (json) => OrderRejected(ApiError.fromJson(json)),
}),
```
Побеждает точный код, затем шаблон с наименьшим числом `x`.
С собственными условиями:
```dart
OneOf.byJson({
(json, response) => response.statusCode == 200 && json['status'] == 'ok': SignUpComplete.fromJson,
(json, response) => response.statusCode == 200 && json['status'] == 'verify': VerifyEmail.fromJson,
}),
```
С функцией:
```dart
OneOf((json, response) => switch ((response.statusCode, json)) {
(200, {'status': 'placed'}) => OrderPlaced.fromJson(json),
(200, _) => OrderPending.fromJson(json),
_ => null,
}),
```
Читайте форму из ответа с помощью `dataAs()` и `dataIs()`; см. [NyResponse](/docs/7.x/networking#ny-response).
Metro создаёт родителя, его подтипы и запись `OneOf.byKey` за вас:
```bash
metro make:model login_result --one-of="success,two_factor"
```
См. [Make a OneOf model](/docs/7.x/metro#make-a-one-of-model).
## Декодеры API
Декодеры API используются при вызове вспомогательного метода `api`.
```dart
loadUser() async {
User user = await api((request) => request.fetchUser());
}
```
Помощник `api` сопоставляет нужный API-сервис с помощью generics, поэтому вы можете вызвать следующий помощник для доступа к вашему сервису.
```dart
await api((request) => request.callMyMethod());
```
Перед использованием помощника `api` необходимо сначала добавить ваш API-сервис в lib/config/decoders.dart > apiDecoders.
```dart
final Map apiDecoders = {
ApiService: ApiService(),
// ...
};
```