JSON 轉 Kotlin

從 JSON 樣本產生 Kotlin data class 宣告。不可變模型使用 val 屬性、 樣本中為 null 的欄位使用 nullable 型別(String?), 不是合法 Kotlin 識別字的 JSON 鍵會加上 Gson @SerializedName annotation。使用 package 選項 設定 package 宣告。底層使用 quicktype,完全在你的瀏覽器內運作。

貼上 JSON(或載入範例),即可在右側讀到 Kotlin data class。在選項 面板設定 package name 對應你的模組布局;預設輸出對不是合法 Kotlin 識別字的 JSON 鍵使用 Gson @SerializedName。

輸入: {"id":42,"name":"devsmiths","createdAt":"2024-03-11T08:24:00Z","stars":1280,"public":true,"contributors":[{"login":"ada","commits":51,"admin":true},{"login":"linus","commits":33,"admin":false}],"homepage":null}

輸出(Kotlin):

package com.devsmiths

import com.google.gson.annotations.SerializedName

data class Root(
    val id: Long,
    val name: String,
    @SerializedName("createdAt") val createdAt: String,
    val stars: Long,
    val public: Boolean,
    val contributors: List<Contributor>,
    val homepage: String? = null,
)

data class Contributor(
    val login: String,
    val commits: Long,
    val admin: Boolean,
)

• 輸出採 data class 配 Gson @SerializedName。 要改用 kotlinx.serialization,把 @SerializedName 換成 @SerialName、在每個 class 上加 @Serializable、 import kotlinx.serialization.*。
• 屬性為 val(不可變)。需要 var(例如配合 Android DataBinding)時請手動改——產生器偏向不可變, 因為多數 JSON DTO 解析後應該唯讀。
• Nullable 型別對樣本中為 null 的欄位用 String?。 搭配預設值(val homepage: String? = null)能讓 Gson 與 Moshi 在缺漏鍵時優雅處理。
• 整數一律 Long,與大小無關。小 ID 可手動改 Int; Gson 與 Moshi 兩者皆可解碼。浮點預設 Double。
• 日期字串保持為 String,不是 java.time.Instant 或 kotlinx.datetime.Instant。若需型別化日期, 為 Gson 加 TypeAdapter 或為 kotlinx.serialization 加 KSerializer。
• 單樣本推論:樣本中不存在的鍵不會自動變 nullable。all optional 會讓每個欄位變 T? = null。