Füge eine API-Antwort oder ein Konfigurations-JSON ein und erhalte Kotlin-Code mit data class, der dessen Struktur abbildet. Verschachtelte Objekte und Arrays von Objekten werden jeweils zu eigenen Klassen, und als Ziel kannst du kotlinx.serialization oder Jackson wählen.
Gedacht ist das für den Moment, in dem du in einer Android-App oder einem Ktor/Spring-Service eine externe API anbindest und das Modellgerüst lieber aus einer Beispielantwort gewinnst, statt es abzutippen. Die Umwandlung läuft komplett in deinem Browser, eine eingefügte interne API-Antwort wird also nirgendwohin gesendet.
Typname auf den Namen der obersten Klasse (Standard Root), zum Beispiel UserResponse.Serializer kotlinx.serialization oder Jackson, passend zu dem, was dein Projekt bereits verwendet.{
"orderId": "A-1024",
"paid": true,
"total": 39.9,
"coupon": null,
"items": [
{ "sku": "TSHIRT-M", "qty": 2 },
{ "sku": "CAP", "qty": 1, "gift_wrap": true }
]
}import kotlinx.serialization.Serializable
import kotlinx.serialization.SerialName
import kotlinx.serialization.json.JsonElement
@Serializable
data class Order(
val orderId: String,
val paid: Boolean,
val total: Double,
val coupon: JsonElement? = null,
val items: List<Item>
)
@Serializable
data class Item(
val sku: String,
val qty: Int,
@SerialName("gift_wrap") val giftWrap: Boolean? = null
)
Objekte im Array items werden zu einer Klasse Item im Singular, und gift_wrap, das nur im zweiten Element vorkommt, wird zu Boolean? = null. coupon ist immer nur null, sein Typ lässt sich also nicht ableiten; es bleibt JsonElement?, damit du es durch den echten Typ ersetzt.
@Serializable an jeder Klasse, @SerialName an Feldern mit geändertem Namen, dazu die nötigen Imports.@JsonProperty nur an Feldern mit geändertem Namen.user_name oder home-url werden zu camelCase-Properties (userName, homeUrl), die per Annotation auf den ursprünglichen Key zurückgeführt werden.class oder val werden in Backticks gesetzt; Keys, die mit einer Ziffer beginnen, bekommen das Präfix n.Int, Werte über 32 Bit zu Long, und jede Dezimalzahl macht das Feld zu Double.? = null.typealias, z. B. typealias Root = List<RootItem>.Füge eine aus Postman oder den DevTools des Browsers kopierte Antwort ein und du bekommst Klassen, die für Call<Order> oder client.get<Order>() bereit sind. Bei Antworten mit Dutzenden Feldern vermeidest du so Tippfehler und falsche Typen durch Abschreiben.
Sendet das Backend created_at, liest die Kotlin-Seite createdAt, während der Serial Name den ursprünglichen Key behält. Die Zuordnung bleibt pro Klasse sichtbar, statt von einer globalen Naming-Strategie abzuhängen.
Ziehst du Gson- oder Jackson-Modelle zu kotlinx.serialization um, erzeuge beide Ausgaben aus demselben JSON, um genau zu sehen, welche Annotationen sich ändern.
? selbst bei Feldern, die laut API-Doku fehlen dürfen.2024-01-01T00:00:00Z bleiben String; für einen Wechsel zu Instant brauchst du einen eigenen Serializer.Any nicht serialisieren, daher werden Werte ohne ableitbaren Typ dort zu JsonElement und bei Jackson zu Any.String? = null und nicht einfach String??kotlinx.serialization wirft MissingFieldException, wenn ein Key fehlt und die Property keinen Standardwert hat. Mit = null an Feldern, die in manchen Elementen fehlen oder null enthalten, lassen sich Antworten ohne diesen Key sauber dekodieren.
@SerialName als Property-Namen behalten?Das Tool wandelt immer in camelCase um und ergänzt eine Annotation nur, wenn der Name abweicht; Keys, die bereits camelCase sind, kommen also ohne Annotation heraus. Um snake_case-Namen zu behalten, benenne die Properties nach dem Erzeugen um und entferne die Annotationen.
Ja. Die erzeugte data class hat keinen parameterlosen Konstruktor, daher muss jackson-module-kotlin registriert sein, damit Jackson Werte über Konstruktorparameter bindet (Spring Boot registriert es automatisch, wenn die Abhängigkeit vorhanden ist).
Als Serializer stehen kotlinx.serialization und Jackson zur Wahl. Für Gson nimmst du die Jackson-Ausgabe und ersetzt @JsonProperty durch @SerializedName; für Moshi verwendest du @Json(name = ...). Die Klassenstruktur bleibt gleich.