Ubah JSON menjadi Codable struct Swift!

Masukkan JSON untuk membuat kode Codable struct Swift, termasuk objek bersarang! Mendukung Codable, CodingKeys, JSONDecoder, iOS.
JSON
Hasil
 

Ubah JSON menjadi Codable struct Swift!

Konversikan JSON menjadi struct Swift yang mengadopsi Codable. Properti dideklarasikan dengan let dan diganti namanya ke camelCase, dan enum CodingKeys hanya dibuat untuk struct yang punya nama berbeda dari key JSON-nya.

Gunakan ketika aplikasi iOS atau macOS butuh model untuk men-decode respons URLSession dengan JSONDecoder, atau ketika Anda ingin tipe yang cocok dengan mock JSON di balik preview SwiftUI.

Cara menggunakan

  1. Tempel body respons dari API Anda, misalnya yang ditangkap dengan Proxyman atau Charles.
  2. Isi Nama tipe dengan nama struct tingkat atas (misalnya EpisodePage).
  3. Tempel hasilnya ke file Swift; import Foundation sudah disertakan.
  4. Decode dengan try JSONDecoder().decode(EpisodePage.self, from: data).

Contoh

Input (JSON)
{
  "podcast": "Swift Talk",
  "episodes": [
    { "id": 301, "title": "Async Sequences", "duration": 1840, "explicit": false },
    { "id": 302, "title": "Macros", "duration": 2215.5, "explicit": false, "guest_name": "Chris" }
  ],
  "total_count": 2
}
Output (Swift · Codable)
import Foundation

struct EpisodePage: Codable {
    let podcast: String
    let episodes: [Episode]
    let totalCount: Int

    enum CodingKeys: String, CodingKey {
        case podcast
        case episodes
        case totalCount = "total_count"
    }
}

struct Episode: Codable {
    let id: Int
    let title: String
    let duration: Double
    let explicit: Bool
    let guestName: String?

    enum CodingKeys: String, CodingKey {
        case id
        case title
        case duration
        case explicit
        case guestName = "guest_name"
    }
}

Elemen array episodes menjadi struct Episode. duration mencampur integer (1840) dan desimal (2215.5), jadi bertipe Double; guest_name, yang hanya ada di episode kedua, menjadi guestName: String?. Setiap struct yang punya field yang diganti namanya mendapat enum CodingKeys berisi semua key-nya.

Fitur yang didukung

  • Setiap struct mengadopsi Codable; properti berupa let yang immutable.
  • Key snake_case dan kebab-case menjadi properti camelCase, dan hanya dalam kasus itu enum CodingKeys: String, CodingKey ditambahkan dengan key aslinya.
  • Tipe: String, Int, Double, Bool, dan [T] untuk array.
  • Field yang tidak ada di sebagian item atau berisi null menjadi Optional (String?), jadi key yang hilang tetap bisa di-decode.
  • Nilai bertipe campuran memakai enum JSONValue yang dihasilkan dan bisa di-decode.
  • Keyword Swift seperti default, class atau self dibungkus backtick.
  • Array tingkat atas menghasilkan typealias Root = [RootItem].

Kasus penggunaan

URLSession dengan async/await

Dari satu contoh respons Anda mendapat model yang bisa di-decode tepat di baris setelah let (data, _) = try await URLSession.shared.data(from: url).

Layar daftar SwiftUI

Tambahkan Identifiable ke struct yang dihasilkan (jika punya field id) dan berikan langsung ke List(page.episodes) { ... }.

Mock data yang dibundel

Sertakan contoh JSON dari tahap desain di bundle aplikasi dan decode dengan model yang sama, sehingga layar bisa dibangun sebelum API sebenarnya siap.

Catatan dan batasan

  • String tanggal keluar sebagai String. Untuk mendapatkan Date, ubah tipe propertinya dan atur strategi seperti decoder.dateDecodingStrategy = .iso8601.
  • Jika key dari properti non-optional tidak ada di sebuah respons, decoding melempar DecodingError.keyNotFound. Tambahkan ? ke field yang mungkin dihilangkan API, meskipun contoh Anda selalu memilikinya.
  • Semua properti berupa let; ganti ke var untuk model yang Anda ubah sebagai view state.
  • Tidak ada protocol tambahan seperti Identifiable atau Hashable yang diadopsi.
  • Enum JSONValue adalah kode pembantu untuk tipe campuran; jika proyek Anda sudah punya tipe yang setara, hapus dan gunakan milik Anda.

FAQ

Dengan keyDecodingStrategy = .convertFromSnakeCase, bisakah CodingKeys dihapus?

Bisa, decoder kemudian mengonversi guest_name ↔ guestName untuk Anda. Namun jangan gabungkan keduanya: decoder mengonversi key ke camelCase terlebih dahulu lalu membandingkannya dengan raw value "guest_name" di CodingKeys, sehingga pencocokannya gagal.

Mengapa struct dan bukan class?

Memperlakukan model respons sebagai value type adalah konvensi umum di Swift, dan struct mendapat memberwise initializer secara gratis, sehingga data uji mudah dibuat. Jika Anda butuh semantik reference, ganti ke final class dan tambahkan initializer.

Field yang saya kira integer keluar sebagai Double.

Ketika sebuah key berisi integer sekaligus desimal, Double menghindari hilangnya presisi. Sebaliknya, jika semua nilai contoh tampak seperti 4.0, parser JSON browser membacanya sebagai integer dan Anda mungkin mendapat Int, jadi periksa nilai API yang sebenarnya.

Apakah encoding kembali ke JSON mempertahankan key aslinya?

CodingKeys juga dipakai untuk encoding, jadi JSONEncoder kembali menulis guest_name. Properti optional yang bernilai nil dihilangkan dari output.