: (data) => List.from(data).map((json) => User.fromJson(json)).toList(),
User: (data) => User.fromJson(data),
// ...
};
```
Trong file modelDecoders, chúng ta cần cung cấp `Type` làm khóa và xử lý chuyển đổi trong giá trị như ví dụ trên.
Tham số `data` sẽ chứa payload từ yêu cầu API.
## Typed Decoders
Yêu cầu
Nylo 7.5.0+
nylo_support 7.37.0+
`decoders([...])` xây dựng map `modelDecoders` của bạn từ một danh sách. `Decode(User.fromJson)` giải mã một `User`, và cả `List`, mà không cần mục riêng:
```dart
final Map modelDecoders = decoders([
Decode(User.fromJson),
Decode(Order.fromJson, from: 'data'),
]);
```
Dùng `from` để đọc model từ bên trong một body được bọc, như `{"data": {...}}`. Một khóa có dấu chấm như `'data.user'` đọc sâu hơn, và với danh sách, chính danh sách được đọc từ `from`.
`Decode` nhận một `fromJson` chấp nhận `dynamic` hoặc `Map`. Với closure, hãy khai báo kiểu cho tham số của nó:
```dart
Decode((dynamic json) => User.fromJson(json)),
```
Các closure decoder trong map `{...}`, như `User: (data) => User.fromJson(data)`, vẫn hoạt động. Cả hai đều là một `NyDecoder`, lớp mà `Decode` và `OneOf` kế thừa. Một `NyDecoder` tùy chỉnh triển khai `decode(json, response, decoders)` và thấy toàn bộ `NyResponse`, nên nó có thể đọc mã trạng thái hoặc header.
## OneOf
Yêu cầu
Nylo 7.5.0+
nylo_support 7.37.0+
`OneOf` giải mã một phản hồi có thể có nhiều hình dạng. Đăng ký nó dưới kiểu cha dùng chung, và chọn hình dạng theo một trường trong body, theo mã trạng thái, hoặc bằng các điều kiện của riêng bạn:
```dart
final Map modelDecoders = decoders([
OneOf.byKey('status', {
'success': LoginSuccess.fromJson,
'two_factor': TwoFactorRequired.fromJson,
}, otherwise: (json) => LoginFailed(ApiError.fromJson(json))),
]);
```
Một `OneOf` cũng giải mã body 4xx và 5xx, và từng phần tử của `List`. Một hình dạng mà nó không nhận ra sẽ để dữ liệu phản hồi là null.
| Constructor | Chọn hình dạng theo |
|-------------|--------------------|
| `OneOf.byKey(key, types, otherwise:)` | Giá trị của `key` trong body. Một khóa có dấu chấm như `'data.type'` đọc một trường lồng nhau |
| `OneOf.byStatus(types, otherwise:)` | Mã trạng thái. Một khóa là một mã như `404`, hoặc một mẫu như `'4xx'` hoặc `'40x'` |
| `OneOf.byJson(types, otherwise:)` | Các điều kiện của riêng bạn, mỗi điều kiện nhận body và response. Điều kiện đầu tiên trả về true sẽ thắng |
| `OneOf(resolve)` | Một hàm nhận body và response rồi trả về giá trị, hoặc null |
Theo mã trạng thái:
```dart
OneOf.byStatus({
200: OrderPlaced.fromJson,
404: OrderNotFound.fromJson,
'4xx': (json) => OrderRejected(ApiError.fromJson(json)),
}),
```
Mã chính xác thắng, sau đó đến mẫu có ít chữ `x` nhất.
Với các điều kiện của riêng bạn:
```dart
OneOf.byJson({
(json, response) => response.statusCode == 200 && json['status'] == 'ok': SignUpComplete.fromJson,
(json, response) => response.statusCode == 200 && json['status'] == 'verify': VerifyEmail.fromJson,
}),
```
Với một hàm:
```dart
OneOf((json, response) => switch ((response.statusCode, json)) {
(200, {'status': 'placed'}) => OrderPlaced.fromJson(json),
(200, _) => OrderPending.fromJson(json),
_ => null,
}),
```
Đọc hình dạng từ một response bằng `dataAs()` và `dataIs()`; xem [NyResponse](/docs/7.x/networking#ny-response).
Metro tạo kiểu cha, các kiểu con của nó và mục `OneOf.byKey` cho bạn:
```bash
metro make:model login_result --one-of="success,two_factor"
```
Xem [Tạo model OneOf](/docs/7.x/metro#make-a-one-of-model).
## API decoders
API decoders được sử dụng khi gọi phương thức helper `api`.
```dart
loadUser() async {
User user = await api((request) => request.fetchUser());
}
```
Helper `api` sẽ khớp đúng API Service sử dụng generics, vì vậy bạn có thể gọi helper bên dưới để truy cập service của mình.
```dart
await api((request) => request.callMyMethod());
```
Trước khi sử dụng helper `api`, bạn cần thêm API Service vào lib/config/decoders.dart > apiDecoders.
```dart
final Map apiDecoders = {
ApiService: ApiService(),
// ...
};
```