Ubah JSON menjadi class Dart!

Masukkan JSON untuk membuat kode class Dart, termasuk objek bersarang! Mendukung Flutter, fromJson, toJson.
JSON
Hasil
 

Ubah JSON menjadi class Dart!

Ubah JSON menjadi class Dart dengan factory fromJson dan method toJson. Kodenya Dart murni tanpa package code generation, jadi tidak ada langkah build_runner.

Cocok untuk aplikasi Flutter yang mengoper respons Map<String, dynamic> mentah dari http atau dio ke widget dan ingin memakai class model yang layak, atau proyek kecil yang butuh serialisasi yang berfungsi sebelum mengadopsi json_serializable.

Cara menggunakan

  1. Tempel JSON yang ingin dikonversi.
  2. Isi nama class tingkat atas di Nama tipe (misalnya Store).
  3. Tempel output ke file di bawah lib/models/; tidak perlu import apa pun.
  4. Buat objek dengan Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) dan kirim dengan jsonEncode(store.toJson()).

Contoh

Input (JSON)
{
  "storeId": 77,
  "storeName": "Mapo Kimbap",
  "isOpen": true,
  "rating": 4.7,
  "menuItems": [
    { "name": "Tuna Kimbap", "price": 4500, "soldOut": false },
    { "name": "Ramyeon", "price": 5000, "soldOut": true, "spicy": 2 }
  ]
}
Output (Dart)
class Store {
  final int storeId;
  final String storeName;
  final bool isOpen;
  final double rating;
  final List<MenuItem> menuItems;

  Store({
    required this.storeId,
    required this.storeName,
    required this.isOpen,
    required this.rating,
    required this.menuItems,
  });

  factory Store.fromJson(Map<String, dynamic> json) => Store(
        storeId: json['storeId'] as int,
        storeName: json['storeName'] as String,
        isOpen: json['isOpen'] as bool,
        rating: (json['rating'] as num).toDouble(),
        menuItems: (json['menuItems'] as List<dynamic>).map((e) => MenuItem.fromJson(e as Map<String, dynamic>)).toList(),
      );

  Map<String, dynamic> toJson() => {
        'storeId': storeId,
        'storeName': storeName,
        'isOpen': isOpen,
        'rating': rating,
        'menuItems': menuItems.map((e) => e.toJson()).toList(),
      };
}

class MenuItem {
  final String name;
  final int price;
  final bool soldOut;
  final int? spicy;

  MenuItem({
    required this.name,
    required this.price,
    required this.soldOut,
    this.spicy,
  });

  factory MenuItem.fromJson(Map<String, dynamic> json) => MenuItem(
        name: json['name'] as String,
        price: json['price'] as int,
        soldOut: json['soldOut'] as bool,
        spicy: json['spicy'] as int?,
      );

  Map<String, dynamic> toJson() => {
        'name': name,
        'price': price,
        'soldOut': soldOut,
        'spicy': spicy,
      };
}

Elemen array menuItems menjadi class MenuItem, yang dikonversi di dalam fromJson dengan .map(...).toList(). rating dibaca sebagai (json['rating'] as num).toDouble() sehingga nilai integer tetap aman, dan spicy, yang hanya ada di sebagian item menu, menjadi int? tanpa required di constructor.

Fitur yang didukung

  • Semua field final; constructor memakai named parameter ({required this.x}).
  • factory X.fromJson(Map<String, dynamic> json) dan Map<String, dynamic> toJson() bergaya tulisan tangan tanpa dependensi package.
  • Objek bersarang dan array objek memanggil fromJson / toJson milik class anaknya.
  • Field double dibaca lewat (as num).toDouble(), jadi integer JSON seperti 4 tidak memicu cast error.
  • Field yang tidak ada di sebagian item atau berisi null menjadi nullable (int?) dan meneruskan null di fromJson.
  • Nilai bertipe campuran menjadi dynamic; kata kunci Dart seperti class atau is diberi garis bawah di belakang.
  • Array tingkat atas menghasilkan typedef Root = List<RootItem>;.

Kasus penggunaan

Model API untuk layar Flutter

Mengoper Map lewat FutureBuilder atau state Riverpod/Bloc menyembunyikan salah ketik key sampai runtime. Dengan class yang dihasilkan, Anda mendapat autocomplete dan pemeriksaan tipe pada store.menuItems.first.price.

Caching lokal

Simpan jsonEncode(store.toJson()) di shared_preferences atau file lalu pulihkan dengan fromJson saat startup untuk cache hanya dalam beberapa baris.

Draf sebelum json_serializable

Pastikan daftar field dan tipenya terlebih dahulu; ketika proyek berkembang, tambahkan @JsonSerializable() ke field yang sama dan beralih ke code generation.

Catatan dan batasan

  • Tipe disimpulkan dengan parser JSON browser, yang membaca 5000.0 sebagai integer 5000. jsonDecode di Dart mempertahankan 5000.0 sebagai double, sehingga as int akan melempar error. Ubah field harga atau koordinat yang mungkin memakai titik desimal menjadi double.
  • toJson tetap menulis field nullable meskipun bernilai null ('spicy': null). Jika server Anda menolak key null, hilangkan secara kondisional.
  • String tanggal tetap String; konversikan sendiri dengan DateTime.parse(json['createdAt'] as String).
  • Tidak ada copyWith, ==/hashCode atau toString yang dibuat. Pertimbangkan freezed atau equatable jika Anda membutuhkannya.
  • Field dynamic menyimpan nilai tanpa pemeriksaan; ganti setelah Anda mengetahui tipe sebenarnya.

FAQ

Bisakah membuat kode json_serializable atau freezed?

Output-nya berupa fromJson/toJson bergaya tulisan tangan tanpa package. Ambil deklarasi field-nya, tambahkan @JsonSerializable() dan part 'store.g.dart';, lalu jalankan dart run build_runner build untuk beralih ke code generation.

Saya mendapat type 'int' is not a subtype of type 'double'.

Itu terjadi ketika kode melakukan cast dengan as double sedangkan nilai JSON-nya integer. Field double yang dihasilkan memakai (as num).toDouble() untuk menghindarinya; terapkan pola yang sama pada field yang Anda edit manual.

Bagaimana cara men-decode respons berupa list ([ {...}, {...} ])?

Array tingkat atas menghasilkan typedef dan class elemen. Panggil fromJson per elemen: (jsonDecode(body) as List<dynamic>).map((e) => RootItem.fromJson(e as Map<String, dynamic>)).toList().

Apakah bisa dipakai di proyek lama tanpa null safety?

Output memakai sintaks sound null safety (int?, required) dari Dart 2.12 ke atas. Proyek sebelum null safety perlu menghapus ? dan required agar bisa di-compile.