Travailler avec JSON en Kotlin : analyse et sérialisation pour débutants

Introduction : pourquoi Kotlin sait-il travailler avec JSON ?

JSON (JavaScript Object Notation) est un format léger d'échange de données, devenu un standard pour les applications web modernes et les API. Si vous programmez en Kotlin, que ce soit pour une application Android ou un backend, tôt ou tard vous devrez analyser des réponses JSON provenant d'un serveur ou sérialiser vos propres objets pour les envoyer.

Kotlin est un langage moderne qui fonctionne sur la JVM et est entièrement compatible avec Java. Cependant, Kotlin dispose de ses propres outils puissants pour travailler avec JSON, rendant le code plus concis et plus sûr. Dans cet article, nous aborderons les deux approches les plus populaires : l'utilisation de la bibliothèque officielle kotlinx.serialization et de la bibliothèque éprouvée Gson.

Cet article est destiné aux débutants. Nous commencerons par une analyse simple d'une chaîne, puis nous passerons à la création de structures imbriquées complexes, et enfin nous aborderons la sérialisation — la transformation de vos objets en JSON.

1. Préparation du projet : dépendances et imports

Avant d'écrire du code, vous devez ajouter les bibliothèques. Nous examinerons deux options.

1.1. Installation de kotlinx.serialization

C'est la solution officielle de JetBrains. Ajoutez ceci au fichier build.gradle.kts :

plugins {\n    kotlin("jvm") version "1.9.0"\n    kotlin("plugin.serialization") version "1.9.0"\n}\n\ndependencies {\n    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0")\n}\n

1.2. Installation de Gson

Gson est une bibliothèque de Google. Elle est plus simple à configurer, mais nécessite plus de travail manuel :

dependencies {\n    implementation("com.google.code.gson:gson:2.10.1")\n}\n

Après la synchronisation du projet, vous pouvez écrire du code.

2. Analyse JSON en Kotlin avec kotlinx.serialization

Cette approche est la plus « kotlinesque ». Vous déclarez des data-classes et ajoutez l'annotation @Serializable. La bibliothèque génère elle-même le code d'analyse.

2.1. Exemple simple : données utilisateur

Supposons que nous ayons une chaîne JSON :

{\n    "name": "Anna",\n    "age": 25,\n    "email": "anna@example.com"\n}\n

Créons le modèle :

import kotlinx.serialization.Serializable\nimport kotlinx.serialization.json.Json\n\n@Serializable\ndata class User(\n    val name: String,\n    val age: Int,\n    val email: String\n)\n\nfun main() {\n    val jsonString = """\n        {\n            "name": "Anna",\n            "age": 25,\n            "email": "anna@example.com"\n        }\n    """.trimIndent()\n\n    val user = Json.decodeFromString<User>(jsonString)\n    println("Nom : ${user.name}, Âge : ${user.age}")\n}\n

Comme vous pouvez le voir, aucun mappage manuel — tout est automatique.

2.2. Travailler avec des listes et des objets imbriqués

Les API réelles renvoient souvent des tableaux. Ajoutons un champ address :

@Serializable\ndata class Address(\n    val city: String,\n    val street: String\n)\n\n@Serializable\ndata class UserWithAddress(\n    val name: String,\n    val age: Int,\n    val address: Address\n)\n\nfun main() {\n    val jsonArray = """\n        [\n            {"name": "Ivan", "age": 30, "address": {"city": "Moscou", "street": "Tverskaïa"}},\n            {"name": "Maria", "age": 22, "address": {"city": "Saint-Pétersbourg", "street": "Nevski"}}\n        ]\n    """.trimIndent()\n\n    val users = Json.decodeFromString<List<UserWithAddress>>(jsonArray)\n    users.forEach { println("${it.name} vit à ${it.address.city}") }\n}\n

Notez : pour travailler avec des listes, on utilise le générique List<UserWithAddress>.

3. Analyse JSON avec Gson

Gson est une bibliothèque Java classique. Elle fonctionne également très bien en Kotlin, mais nécessite un peu plus de code.

3.1. Analyse de base

import com.google.gson.Gson\n\ndata cl