Konverter JSON ke Dart

Cara JSON diubah menjadi model Dart null-safe

Dokumentasi resmi dart:convert menjelaskan bahwa jsonDecode() menghasilkan nilai yang kompatibel dengan JSON, seperti angka, string, Boolean, null, list, dan map dengan key string. Class model tidak dapat langsung diubah menjadi JSON, tetapi jsonEncode() dapat memanggil method toJson() miliknya. Konverter ini menghasilkan pola serialisasi manual tersebut tanpa menambahkan anotasi json_serializable atau dependensi package.

Misalnya, sampel berisi pengguna dengan alamat bertingkat. User yang dihasilkan memiliki field final dan constructor dengan parameter bernama. User.fromJson(Map<String, Object?> json) melakukan cast pada nilai skalar dan memanggil UserAddress.fromJson() untuk objek bertingkat. Jika address hilang atau bernilai null pada salah satu objek sampel, tipenya menjadi UserAddress? dan factory memeriksa null sebelum membuat objeknya. Saat toJson diaktifkan, model bertingkat diubah secara rekursif menjadi map yang dapat diterima jsonEncode().

Konverter memeriksa setiap objek dalam larik utama, bukan hanya memercayai item pertama. Sebuah field menjadi nullable ketika field itu tidak ada pada salah satu item atau secara eksplisit bernilai null. Anda juga dapat menjadikan semua field nullable jika API sebenarnya lebih sulit diprediksi daripada sampelnya. Panduan null safety Dart menjelaskan bahwa secara default tipe tidak menerima null dan memerlukan ? agar dapat menerima null.

Penanganan identifier dan batas inferensi

Key JSON tidak harus berupa nama anggota Dart yang valid. Tanda baca dihapus, kata diubah menjadi lowerCamelCase, kata yang dicadangkan mendapat akhiran aman, dan benturan nama mendapat akhiran angka yang konsisten. Key asli tidak berubah di json['original-key'] dan map toJson(). Nama class bertingkat menggunakan path lengkap agar objek alamat yang tidak berkaitan tidak diam-diam dijadikan satu class.

Satu sampel tidak dapat membuktikan keseluruhan kontrak API. String JSON tidak otomatis dikenali sebagai tanggal, UUID, atau enum, sedangkan larik kosong tidak memberikan informasi tentang tipe elemennya. Nama anggota objek yang berulang juga tidak aman untuk proses bolak-balik karena parser JSON umumnya mempertahankan nilai terakhir. Bandingkan model yang dihasilkan dengan dokumentasi atau skema API sebelum menggunakannya di production. Alat ini membatasi ukuran input, kedalaman, jumlah deklarasi hasil inferensi, dan ukuran output agar kerja browser tetap terkendali.