: (data) => List.from(data).map((json) => User.fromJson(json)).toList(),
User: (data) => User.fromJson(data),
// ...
};
```
Di file modelDecoders, kita perlu menyediakan `Type` sebagai kunci dan menangani transformasi di nilai seperti contoh di atas.
Argumen `data` akan berisi payload dari permintaan API.
## Decoder Bertipe
Persyaratan
Nylo 7.5.0+
nylo_support 7.37.0+
`decoders([...])` membangun map `modelDecoders` Anda dari sebuah list. `Decode(User.fromJson)` mendekode sebuah `User`, dan juga `List`, tanpa entri tersendiri:
```dart
final Map modelDecoders = decoders([
Decode(User.fromJson),
Decode(Order.fromJson, from: 'data'),
]);
```
Gunakan `from` untuk membaca model dari dalam body yang dibungkus, seperti `{"data": {...}}`. Kunci bertitik seperti `'data.user'` membaca lebih dalam, dan untuk list, list itu sendiri dibaca dari `from`.
`Decode` menerima `fromJson` yang menerima `dynamic` atau `Map`. Untuk closure, tentukan tipe parameternya:
```dart
Decode((dynamic json) => User.fromJson(json)),
```
Decoder closure dalam map `{...}`, seperti `User: (data) => User.fromJson(data)`, tetap berfungsi. Keduanya adalah `NyDecoder`, kelas yang di-extend oleh `Decode` dan `OneOf`. Sebuah `NyDecoder` kustom mengimplementasikan `decode(json, response, decoders)` dan melihat seluruh `NyResponse`, sehingga dapat membaca kode status atau header.
## OneOf
Persyaratan
Nylo 7.5.0+
nylo_support 7.37.0+
`OneOf` mendekode respons yang bisa memiliki lebih dari satu bentuk. Daftarkan di bawah tipe induk yang sama, lalu pilih bentuknya berdasarkan sebuah field di body, kode status, atau kondisi Anda sendiri:
```dart
final Map modelDecoders = decoders([
OneOf.byKey('status', {
'success': LoginSuccess.fromJson,
'two_factor': TwoFactorRequired.fromJson,
}, otherwise: (json) => LoginFailed(ApiError.fromJson(json))),
]);
```
`OneOf` juga mendekode body 4xx dan 5xx, serta item `List` satu per satu. Bentuk yang tidak dikenali membuat data respons bernilai null.
| Constructor | Memilih bentuk berdasarkan |
|-------------|--------------------|
| `OneOf.byKey(key, types, otherwise:)` | Nilai `key` di body. Kunci bertitik seperti `'data.type'` membaca field bersarang |
| `OneOf.byStatus(types, otherwise:)` | Kode status. Kuncinya berupa kode seperti `404`, atau pola seperti `'4xx'` atau `'40x'` |
| `OneOf.byJson(types, otherwise:)` | Kondisi Anda sendiri, masing-masing menerima body dan respons. Yang pertama mengembalikan true akan dipakai |
| `OneOf(resolve)` | Fungsi yang menerima body dan respons lalu mengembalikan nilai, atau null |
Berdasarkan kode status:
```dart
OneOf.byStatus({
200: OrderPlaced.fromJson,
404: OrderNotFound.fromJson,
'4xx': (json) => OrderRejected(ApiError.fromJson(json)),
}),
```
Kode yang persis sama diutamakan, lalu pola dengan `x` paling sedikit.
Dengan kondisi Anda sendiri:
```dart
OneOf.byJson({
(json, response) => response.statusCode == 200 && json['status'] == 'ok': SignUpComplete.fromJson,
(json, response) => response.statusCode == 200 && json['status'] == 'verify': VerifyEmail.fromJson,
}),
```
Dengan sebuah fungsi:
```dart
OneOf((json, response) => switch ((response.statusCode, json)) {
(200, {'status': 'placed'}) => OrderPlaced.fromJson(json),
(200, _) => OrderPending.fromJson(json),
_ => null,
}),
```
Baca bentuk dari sebuah respons dengan `dataAs()` dan `dataIs()`; lihat [NyResponse](/docs/7.x/networking#ny-response).
Metro membuatkan induk, subtipenya, dan entri `OneOf.byKey` untuk Anda:
```bash
metro make:model login_result --one-of="success,two_factor"
```
Lihat [Membuat model OneOf](/docs/7.x/metro#make-a-one-of-model).
## Decoder API
Decoder API digunakan saat memanggil method helper `api`.
```dart
loadUser() async {
User user = await api((request) => request.fetchUser());
}
```
Helper `api` akan mencocokkan API Service yang benar menggunakan generics, sehingga Anda dapat memanggil helper di bawah ini untuk mengakses service Anda.
```dart
await api((request) => request.callMyMethod());
```
Sebelum menggunakan helper `api`, Anda perlu terlebih dahulu menambahkan API Service Anda ke lib/config/decoders.dart > apiDecoders.
```dart
final Map apiDecoders = {
ApiService: ApiService(),
// ...
};
```