Kotlin Academy · Leçon

Encodage et décodage JSON

Convertir vers et depuis JSON

Encodage et décodage JSON est une leçon Kotlin Academy gratuite sur CoddyKit. Ceci est la leçon 3 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 Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Academy comprend 4 leçons au total.

L'objet Json

L'objet Json est au cœur de l'encodage et du décodage. L'instance par défaut est prête à l'emploi, ou vous pouvez en créer une configurée.

import kotlinx.serialization.json.Json

val json = Json

Encoder vers une chaîne

Utilisez encodeToString pour transformer un objet en chaîne JSON.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Book(val title: String, val pages: Int)

fun main() {
    val book = Book("Kotlin in Action", 360)
    val text = Json.encodeToString(book)
    println(text)
}

Décoder depuis une chaîne

Utilisez decodeFromString pour analyser du JSON et le reconvertir en objet. Le type cible est inféré ou fourni explicitement.

import kotlinx.serialization.Serializable
import kotlinx.serialization.decodeFromString
import kotlinx.serialization.json.Json

@Serializable
data class Book(val title: String, val pages: Int)

fun main() {
    val text = "{\"title\":\"Atomic Kotlin\",\"pages\":500}"
    val book = Json.decodeFromString<Book>(text)
    println(book.title)
}

Encoder des listes

Les collections sont encodées automatiquement. Une liste d'objets sérialisables devient un tableau JSON.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Tag(val name: String)

fun main() {
    val tags = listOf(Tag("kotlin"), Tag("json"))
    println(Json.encodeToString(tags))
}

Mise en forme

Configurez un générateur Json { } pour activer une sortie indentée, utile pour la journalisation et le débogage.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Point(val x: Int, val y: Int)

val pretty = Json { prettyPrint = true }

fun main() {
    println(pretty.encodeToString(Point(1, 2)))
}

Ignorer les clés inconnues

Par défaut, le décodage échoue si le JSON contient des clés absentes de votre classe. Définissez ignoreUnknownKeys = true pour les ignorer — pratique lorsque les API évoluent.

import kotlinx.serialization.json.Json

val lenient = Json { ignoreUnknownKeys = true }

Encoder les valeurs par défaut

Par défaut, les propriétés égales à leur valeur par défaut ne sont pas écrites. Activez encodeDefaults = true pour toujours les inclure.

import kotlinx.serialization.json.Json

val withDefaults = Json { encodeDefaults = true }

Utiliser JsonElement

Pour traiter du JSON dynamique, vous pouvez l'analyser dans une arborescence JsonElement plutôt que dans une classe typée.

import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonElement

fun main() {
    val element: JsonElement = Json.parseToJsonElement("{\"a\":1}")
    println(element)
}

Lire les champs d'un JsonObject

Convertissez un JsonElement en JsonObject, accédez aux champs par leur clé, puis convertissez les valeurs primitives.

import kotlinx.serialization.json.Json
import kotlinx.serialization.json.jsonObject
import kotlinx.serialization.json.jsonPrimitive
import kotlinx.serialization.json.int

fun main() {
    val obj = Json.parseToJsonElement("{\"a\":1}").jsonObject
    val a = obj["a"]!!.jsonPrimitive.int
    println(a)
}

Aller-retour

L'encodage suivi du décodage doit restituer un objet égal : c'est un aller-retour. C'est une excellente façon de vérifier la cohérence de votre modèle.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.decodeFromString
import kotlinx.serialization.json.Json

@Serializable
data class P(val x: Int)

fun main() {
    val original = P(42)
    val back = Json.decodeFromString<P>(Json.encodeToString(original))
    println(original == back)
}

Erreurs de décodage courantes

Surveillez ces exceptions à l'exécution :

SerializationException: Unexpected JSON token — JSON malformé
Champ obligatoire manquant — le JSON ne contient pas une propriété sans valeur par défaut
Clé inconnue — désactivez le mode strict avec ignoreUnknownKeys

Vérification rapide

Votre API ajoute fréquemment de nouveaux champs JSON. Quelle configuration empêche le décodage de ne plus fonctionner ?

Récapitulatif

Vous savez maintenant passer des objets au JSON et inversement :

encodeToString / decodeFromString
Configurer avec Json { } : prettyPrint, ignoreUnknownKeys, encodeDefaults
Analyser du JSON dynamique avec JsonElement

Suite : les sérialiseurs personnalisés pour les types non pris en charge.

Questions Fréquemment Posées

La leçon « Encodage et décodage JSON » est-elle gratuite ?

Oui — le texte complet de « Encodage et décodage JSON » 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 Academy, passe à CoddyKit PRO. Le cours Kotlin Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Encodage et décodage JSON » ?

Convertir vers et depuis JSON Tu pratiques Kotlin 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 Academy ?

Aucune expérience préalable n'est requise. Kotlin 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 3 sur 4.

Combien de temps prend la leçon « Encodage et décodage JSON » ?

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 Academy ?

Oui. Chaque leçon Kotlin 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

← Retour à Kotlin Academy