Modèles de données @Serializable
Annotez les modèles pour une analyse sûre à la compilation.
Modèles de données @Serializable est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Kotlin Multiplatform Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
JSON Needs a Map
APIs speak JSON, but your shared code wants Kotlin objects. kotlinx.serialization bridges that gap on every KMP target.
Compile-Time Safety
Unlike reflection-based parsers, this library generates code at compile time, so it works fast and predictably on Android and iOS.
Mark a Class @Serializable
You tag a data class with @Serializable and the compiler writes a serializer for it automatically.
@Serializable
data class User(val id: Int, val name: String)Add the Plugin
The annotation only works once you apply the kotlin-serialization Gradle plugin to your shared module.
plugins { kotlin("plugin.serialization") }Add the Runtime
You also need the JSON runtime dependency in commonMain so the generated code has something to call.
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3")Encode to a String
Turn a model into JSON text with Json.encodeToString, ready to send over the network.
val text = Json.encodeToString(user)Decode From a String
Going the other way, decodeToString's partner reads JSON text back into a typed Kotlin object.
val user = Json.decodeFromString<User>(text)Properties Become Keys
By default each property name becomes the matching JSON key, so id and name map straight across with no extra config.
Nested Models Just Work
If a serializable class holds another serializable class, the whole nested tree serializes together with no manual wiring.
@Serializable
data class Order(val buyer: User)Supported Types
Primitives, strings, lists, maps and other serializable classes are all supported, which covers most real API payloads you will meet.
Truly Multiplatform
Because the serializer is generated Kotlin, the exact same parsing logic runs on every target with no platform-specific code.
Quick Check
What does the @Serializable annotation actually trigger?
Recap
Tag models with @Serializable, add the plugin and runtime, then use Json.encodeToString and decodeFromString to move between objects and JSON.
Questions Fréquemment Posées
La leçon « Modèles de données @Serializable » est-elle gratuite ?
Oui — le texte complet de « Modèles de données @Serializable » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Kotlin Multiplatform Academy, passe à CoddyKit PRO. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Modèles de données @Serializable » ?
Annotez les modèles pour une analyse sûre à la compilation. Tu pratiques Kotlin Multiplatform Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Kotlin Multiplatform Academy ?
Aucune expérience préalable n'est requise. Kotlin Multiplatform Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Modèles de données @Serializable » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Kotlin Multiplatform Academy ?
Oui. Chaque leçon Kotlin Multiplatform Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Modèles de données @Serializable
- @SerialName et mappage personnalisé des champs
- Champs pouvant être nuls, par défaut et facultatifs
- Intégrer la sérialisation à Ktor