JSON in Kotlin Data Class
Füge ein JSON-Objekt oder eine API-Antwort ein und erhalte sofort einsetzbare Kotlin Data Classes mit Eigenschaften in camelCase, nullable Typen und Annotationen wie @SerialName, @SerializedName, @Json oder @JsonProperty. Alles läuft in deinem Browser.
Zuletzt aktualisiert:
Dein JSON wird lokal in diesem Tab verarbeitet und nie hochgeladen. Tipp: Strg + Eingabe erzeugt den Code.
Anleitung: JSON in Kotlin Data Class
- Füge dein JSON in das linke Feld ein oder öffne eine .json-Datei. Ein Beispiel ist geladen, damit du die Ausgabe sofort siehst.
- Benenne die Root-Klasse und lege das Package fest (leer lassen, um die package-Zeile wegzulassen).
- Wähle deine Serialisierungsbibliothek: kotlinx.serialization, Gson, Moshi, Jackson oder keine.
- Wähle Nullability und Stil: nullable Eigenschaften, Standardwerte = null, Int oder Long, val oder var, verschachtelte Klassen.
- Klicke auf Kotlin-Klassen erzeugen und kopiere dann den Code oder lade die .kt-Datei in dein Projekt.
Beispiel: JSON in Kotlin Data Classes
Diese API-Antwort enthält einen snake_case-Schlüssel, ein verschachteltes Objekt, ein Array von Objekten und einen Wert, der null sein kann:
{ "user_id": 42, "display_name": "Ada", "avatar": null,
"posts": [ { "id": 1, "title": "Hello", "score": 4.5 },
{ "id": 2, "title": "Draft", "score": 3, "cover": "a.png" } ] }Mit kotlinx.serialization und den Standardoptionen erzeugt der Generator:
@Serializable
data class Root(
@SerialName("user_id") val userId: Int,
@SerialName("display_name") val displayName: String,
val avatar: JsonElement? = null,
val posts: List<Post>
)
@Serializable
data class Post(
val id: Int,
val title: String,
val score: Double,
val cover: String? = null
)score ist Double, weil ein Element 4.5 hat, und cover ist nullable mit Standardwert, weil nur ein Element es hat. avatar ist immer nur null, daher lässt sich sein echter Typ nicht bestimmen: Es wird zu JsonElement? (oder Any? bei anderen Bibliotheken). Ersetze es durch String?, sobald du den Typ kennst.
Wie JSON-Werte auf Kotlin-Typen abgebildet werden
| JSON-Wert | Kotlin-Typ |
|---|---|
"Text" | String |
42 | Int, oder Long außerhalb von ±2,147,483,647 |
3.14, 1e6 | Double |
true / false | Boolean |
"x" oder null oder ein fehlender Schlüssel | String? = null |
{ … } | Eine data class (oberste Ebene oder verschachtelt) |
{} | JsonObject / Map<String, Any?> |
[1, 2] / [] | List<Int> / List<JsonElement> |
[1, "two"] oder immer null | JsonElement / Any? |
Namensannotationen nach Bibliothek
| Bibliothek | Klassenannotation | Eigenschaftsannotation | Dekodieren |
|---|---|---|---|
| kotlinx.serialization | @Serializable | @SerialName("key") | Json.decodeFromString<Root>(text) |
| Gson | keine | @SerializedName("key") | Gson().fromJson(text, Root::class.java) |
| Moshi (codegen) | @JsonClass(generateAdapter = true) | @Json(name = "key") | moshi.adapter(Root::class.java).fromJson(text) |
| Jackson | keine (KotlinModule registrieren) | @JsonProperty("key") | jacksonObjectMapper().readValue<Root>(text) |
- Unbekannte Schlüssel: kotlinx.serialization wirft bei Schlüsseln ohne Eigenschaft einen Fehler, außer du erstellst den Parser mit
Json { ignoreUnknownKeys = true }. Gson und Moshi ignorieren sie; Jackson schlägt fehl, außerFAIL_ON_UNKNOWN_PROPERTIESist deaktiviert. - kotlinx.serialization braucht sein Compiler-Plugin (
plugin.serializationin Gradle); Moshi-Codegen braucht KSP oder kapt mitmoshi-kotlin-codegen. - Große IDs: Behalte
Longfür numerische IDs über 2,147,483,647, etwa Snowflake-IDs im Twitter-Stil.
Häufige Fragen
Wie werden Kotlin-Eigenschaftsnamen aus JSON-Schlüsseln erstellt?
Jeder Schlüssel wird an Unterstrichen, Bindestrichen, Leerzeichen und camelCase-Grenzen in Wörter zerlegt und in camelCase zusammengesetzt, sodass aus user_name userName und aus email-notifications emailNotifications wird. Weicht der Eigenschaftsname vom Schlüssel ab, fügt der Generator die Namensannotation deiner Bibliothek hinzu (@SerialName, @SerializedName, @Json oder @JsonProperty), damit das Dekodieren weiterhin zum JSON passt.
Welche Eigenschaften werden nullable?
Standardmäßig ist eine Eigenschaft nullable (zum Beispiel String?), wenn ihr Wert irgendwo im JSON null ist oder der Schlüssel bei manchen Elementen eines Arrays fehlt. Du kannst auch alle Eigenschaften nullable machen, was bei APIs, die du nicht kontrollierst, am sichersten ist, oder keine. Mit aktivierter Standardwert-Option erhalten nullable Eigenschaften = null, damit ein fehlender Schlüssel das Dekodieren nicht scheitern lässt.
Warum brauchen kotlinx.serialization-Klassen @Serializable?
kotlinx.serialization erzeugt den Serializer zur Kompilierzeit mit seinem Gradle-Plugin, und zwar nur für Klassen, die mit @Serializable markiert sind. Werte, deren Typ sich nicht bestimmen lässt, etwa ein Feld, das immer null ist oder Strings und Zahlen mischt, erhalten den Typ JsonElement, damit sie trotzdem dekodiert werden können.
Beachtet Gson Kotlin-Standardwerte und Non-Null-Typen?
Nicht vollständig. Sofern nicht jede Eigenschaft einen Standardwert hat, erstellt Gson Objekte, ohne den Kotlin-Konstruktor aufzurufen, sodass ein fehlender Schlüssel eine Non-Null-Eigenschaft mit null belegen kann und Standardwerte übersprungen werden. Wenn dein JSON Felder weglassen kann, wähle bei Gson nullable für „Alle Eigenschaften“ oder verwende kotlinx.serialization oder Moshi-Codegen, die Nullability und Standardwerte von Kotlin beachten.
Wie werden Zahlen typisiert?
Ganze Zahlen werden zu Int, oder zu Long, wenn ein Wert außerhalb des 32-Bit-Bereichs liegt (−2,147,483,648 bis 2,147,483,647); du kannst Long auch überall erzwingen. Zahlen mit Dezimalpunkt oder Exponent werden zu Double. Mischt ein Feld ganze und Dezimalzahlen, wird Double verwendet.
Was passiert mit einem JSON-Array auf oberster Ebene?
Der Elementtyp wird als Data Class erzeugt, und ein Kommentar erinnert dich daran, das JSON als List<Item> zu dekodieren, zum Beispiel mit Json.decodeFromString<List<Item>>(text). Ein Array einfacher Werte auf oberster Ebene wird zu einem typealias wie typealias Root = List<String>.
Wird mein JSON hochgeladen?
Nein. Parsen und Codeerzeugung sind reines JavaScript auf dieser Seite, sodass API-Antworten mit persönlichen oder geheimen Daten nie dein Gerät verlassen.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.