Kotlin Academy · Pelajaran

Pengodean dan Penguraian JSON

Konversikan ke dan dari JSON

Pengodean dan Penguraian JSON adalah pelajaran Kotlin Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Kotlin Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Kotlin Academy mencakup 4 pelajaran total.

Objek Json

Objek Json adalah inti pengodean dan pendekodean. Instans bawaan siap digunakan, atau Anda dapat membuat instans yang dikonfigurasi.

import kotlinx.serialization.json.Json

val json = Json

Mengodekan Menjadi Teks

Gunakan encodeToString untuk mengubah objek menjadi teks JSON.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Book(val title: String, val pages: Int)

fun main() {
    val book = Book("Kotlin in Action", 360)
    val text = Json.encodeToString(book)
    println(text)
}

Mendekodekan dari Teks

Gunakan decodeFromString untuk mengurai JSON kembali menjadi objek. Tipe tujuan dapat disimpulkan atau diberikan secara eksplisit.

import kotlinx.serialization.Serializable
import kotlinx.serialization.decodeFromString
import kotlinx.serialization.json.Json

@Serializable
data class Book(val title: String, val pages: Int)

fun main() {
    val text = "{\"title\":\"Atomic Kotlin\",\"pages\":500}"
    val book = Json.decodeFromString<Book>(text)
    println(book.title)
}

Mengodekan Daftar

Koleksi dikodekan secara otomatis. Daftar objek yang dapat diserialisasi menjadi larik JSON.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Tag(val name: String)

fun main() {
    val tags = listOf(Tag("kotlin"), Tag("json"))
    println(Json.encodeToString(tags))
}

Pencetakan Rapi

Konfigurasikan pembangun Json { } untuk mengaktifkan keluaran berindentasi, yang berguna untuk pencatatan dan penelusuran kesalahan.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Point(val x: Int, val y: Int)

val pretty = Json { prettyPrint = true }

fun main() {
    println(pretty.encodeToString(Point(1, 2)))
}

Mengabaikan Kunci yang Tidak Dikenal

Secara bawaan, pendekodean gagal jika JSON berisi kunci yang tidak ada di kelas Anda. Atur ignoreUnknownKeys = true untuk melewatinya — berguna bagi API yang terus berkembang.

import kotlinx.serialization.json.Json

val lenient = Json { ignoreUnknownKeys = true }

Mengodekan Nilai Bawaan

Secara bawaan, properti yang sama dengan nilai bawaannya tidak ditulis. Aktifkan encodeDefaults = true untuk selalu menyertakannya.

import kotlinx.serialization.json.Json

val withDefaults = Json { encodeDefaults = true }

Bekerja dengan JsonElement

Untuk JSON dinamis, Anda dapat mengurainya menjadi pohon JsonElement, bukan kelas bertipe.

import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonElement

fun main() {
    val element: JsonElement = Json.parseToJsonElement("{\"a\":1}")
    println(element)
}

Membaca Bidang JsonObject

Konversikan JsonElement menjadi JsonObject dan akses bidang berdasarkan kunci, lalu konversikan nilai primitifnya.

import kotlinx.serialization.json.Json
import kotlinx.serialization.json.jsonObject
import kotlinx.serialization.json.jsonPrimitive
import kotlinx.serialization.json.int

fun main() {
    val obj = Json.parseToJsonElement("{\"a\":1}").jsonObject
    val a = obj["a"]!!.jsonPrimitive.int
    println(a)
}

Perjalanan Pulang-Pergi

Pengodean lalu pendekodean seharusnya mengembalikan objek yang sama (perjalanan pulang-pergi). Ini adalah cara yang baik untuk memastikan model Anda berfungsi dengan benar.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.decodeFromString
import kotlinx.serialization.json.Json

@Serializable
data class P(val x: Int)

fun main() {
    val original = P(42)
    val back = Json.decodeFromString<P>(Json.encodeToString(original))
    println(original == back)
}

Galat Pendekodean Umum

Waspadai pengecualian berikut saat program dijalankan:

SerializationException: Unexpected JSON token — JSON cacat
Bidang wajib tidak ada — JSON tidak memiliki properti tanpa nilai bawaan
Kunci tidak dikenal — nonaktifkan pemeriksaan ketat dengan ignoreUnknownKeys

Pemeriksaan Singkat

API Anda sering menambahkan bidang JSON baru. Konfigurasi mana yang mencegah pendekodean gagal?

Ringkasan

Sekarang Anda dapat berpindah antara objek dan JSON:

encodeToString / decodeFromString
Konfigurasikan dengan Json { }: prettyPrint, ignoreUnknownKeys, encodeDefaults
Urai JSON dinamis melalui JsonElement

Selanjutnya: serialisator kustom untuk tipe yang tidak didukung.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Pengodean dan Penguraian JSON” gratis?

Ya — teks lengkap “Pengodean dan Penguraian JSON” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Kotlin Academy, upgrade ke CoddyKit PRO. Kursus Kotlin Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Pengodean dan Penguraian JSON”?

Konversikan ke dan dari JSON Kamu berlatih Kotlin Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Kotlin Academy?

Tidak diperlukan pengalaman sebelumnya. Kotlin Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “Pengodean dan Penguraian JSON” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Kotlin Academy ini?

Ya. Setiap pelajaran Kotlin Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Kotlin Academy