Kotlin Academy · Pelajaran

Kelas yang Dapat Diserialisasi

Beri anotasi pada model

Kelas yang Dapat Diserialisasi adalah pelajaran Kotlin Academy gratis di CoddyKit. Ini adalah pelajaran 2 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.

Anotasi @Serializable

Agar sebuah kelas dapat diserialisasi, beri anotasi @Serializable padanya. Pengaya kompiler kemudian membuat serialisator untuk kelas tersebut.

import kotlinx.serialization.Serializable

@Serializable
data class User(val id: Int, val name: String)

Bekerja dengan Kelas Data

Anda dapat memberi anotasi pada kelas apa pun, tetapi kelas data adalah pilihan yang paling umum untuk model karena kelas tersebut secara otomatis membuat equals, hashCode, dan toString.

Semua properti konstruktor menjadi bidang yang diserialisasi.

Nilai Bawaan

Properti dengan nilai bawaan menjadi opsional saat pendekodean. Jika JSON tidak menyertakannya, nilai bawaan akan digunakan.

@Serializable
data class Config(
    val host: String,
    val port: Int = 8080,
    val secure: Boolean = false
)

Properti Nullable

Tipe nullable dipetakan menjadi null JSON. Properti nullable tanpa nilai bawaan tetap wajib ada dalam JSON, tetapi nilainya boleh null.

@Serializable
data class Profile(
    val name: String,
    val bio: String? = null
)

Mengganti Nama Bidang dengan @SerialName

Nama bidang JSON sering berbeda dari konvensi penamaan Kotlin. Gunakan @SerialName untuk memetakannya.

import kotlinx.serialization.SerialName
import kotlinx.serialization.Serializable

@Serializable
data class Account(
    @SerialName("user_id") val userId: Int,
    @SerialName("full_name") val fullName: String
)

Mengabaikan Properti dengan @Transient

Tandai properti dengan @Transient untuk mengecualikannya dari serialisasi. Properti yang dikecualikan harus memiliki nilai bawaan.

import kotlinx.serialization.Transient
import kotlinx.serialization.Serializable

@Serializable
data class Session(
    val token: String,
    @Transient val cachedAt: Long = 0L
)

Kelas yang Dapat Diserialisasi Bersarang

Kelas yang dapat diserialisasi dapat memuat kelas lain yang juga dapat diserialisasi. Pengaya menangani seluruh grafik secara otomatis.

@Serializable
data class Address(val city: String, val zip: String)

@Serializable
data class Company(val name: String, val address: Address)

Koleksi dalam Model

Koleksi standar seperti List, Set, dan Map dapat diserialisasi secara langsung jika elemennya dapat diserialisasi.

@Serializable
data class Team(
    val name: String,
    val members: List<String>,
    val scores: Map<String, Int>
)

Enumerasi Didukung

Kelas enumerasi dapat diberi anotasi dengan @Serializable dan secara bawaan diserialisasi menjadi namanya. Gunakan @SerialName pada setiap entri untuk menyesuaikannya.

@Serializable
enum class Role {
    @SerialName("admin") ADMIN,
    @SerialName("user") USER
}

Ringkasan Wajib vs Opsional

Sebuah properti wajib ada dalam JSON kecuali memiliki nilai bawaan. Aturan utamanya:

Tanpa nilai bawaan → wajib
Memiliki nilai bawaan → opsional
@Transient → diabaikan, harus memiliki nilai bawaan
Nullable tanpa nilai bawaan → wajib, tetapi boleh bernilai null

Yang Tidak Dapat Diserialisasi Secara Langsung

Tipe tanpa serialisator bawaan, misalnya java.util.Date, java.time.Instant, dan UUID, memerlukan serialisator kustom, yang akan Anda pelajari nanti.

Mencoba menserialisasi tipe tersebut tanpa serialisator menyebabkan galat kompilasi.

Pemeriksaan Singkat

Pernyataan mana tentang @Transient yang benar?

Ringkasan

Anda telah mempelajari cara memberi anotasi pada model:

@Serializable pada kelas
Nilai bawaan membuat bidang menjadi opsional
@SerialName mengganti nama kunci JSON
@Transient mengecualikan bidang (memerlukan nilai bawaan)

Selanjutnya: mengodekan dan mendekodekan JSON.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Kelas yang Dapat Diserialisasi” gratis?

Ya — teks lengkap “Kelas yang Dapat Diserialisasi” 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 “Kelas yang Dapat Diserialisasi”?

Beri anotasi pada model 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 2 dari 4.

Berapa lama pelajaran “Kelas yang Dapat Diserialisasi” 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