Entrée JSON

Sortie Kotlin

Qu'est-ce que JSON vers Kotlin ?

Quand vous construisez une app Android ou un service backend Kotlin et que vous recevez une réponse JSON d'API, vous avez besoin de data classes Kotlin qui correspondent à la structure avant de pouvoir désérialiser quoi que ce soit. Les écrire à la main — surtout avec des objets profondément imbriqués — est lent et source d'erreurs. Cet outil génère automatiquement des data classes Kotlin depuis votre JSON. Collez un exemple de réponse et vous obtiendrez en quelques secondes des modèles prêts à l'emploi pour kotlinx.serialization ou Gson.

La conversion s'exécute dans votre navigateur. Définissez le nom de la data class et le package dans la configuration. Activez Data Class pour la syntaxe data class et Types nullable pour les champs optionnels. Rien n'est envoyé à un serveur.

Comment utiliser cet outil

1

Coller ou importer JSON

Collez votre JSON dans l'éditeur de gauche ou importez un fichier. Utilisez Exemple pour des données d'exemple. Définissez le nom de la data class racine et le package dans la configuration. Activez Data Class et Types nullable selon vos besoins.

2

Vérifier les types générés

Le panneau de droite affiche les data classes Kotlin générées. Les objets imbriqués deviennent des types imbriqués. Les tableaux deviennent List<T>. Utilisez @SerializedName ou @Json si les clés JSON diffèrent des noms de propriété. Pour un JSON invalide, utilisez d'abord le Formatage JSON ou le Validateur JSON.

3

Copier ou télécharger

Utilisez Copier ou Télécharger. Collez dans votre projet Android ou Kotlin. Pour formater le JSON d'abord, utilisez le Formatage JSON. Pour la validation, utilisez le Validateur JSON.

Exemples JSON vers Kotlin

Voici un exemple de génération de data classes Kotlin à partir d'un objet JSON.

Exemple : Enregistrement abonné

Entrée JSON :

Entrée

Sortie Kotlin générée :

Sortie

Quand JSON vers Kotlin aide

Lors du développement d'apps Android ou de services backend Kotlin qui consomment des APIs REST, vous avez besoin de data classes typées. Coller une réponse d'exemple ici vous donne des modèles Kotlin pour Retrofit, Gson ou kotlinx.serialization. Pour les tests d'API, Postman aide.

Questions fréquentes

Comment fonctionnent les data classes Kotlin avec JSON ?

Une data class Kotlin contient des données structurées avec des méthodes equals, hashCode, toString et copy générées automatiquement. Des bibliothèques comme Gson et kotlinx.serialization utilisent les propriétés de la classe pour mapper les champs JSON. Générez la data class ici, ajoutez les annotations correctes et désérialisez avec Gson.fromJson ou Json.decodeFromString.

Comment parser du JSON avec Retrofit en Kotlin ?

Ajoutez une factory de convertisseur Gson ou kotlinx.serialization à votre builder Retrofit, puis définissez votre interface API avec un type de retour data class. Générez la data class depuis votre réponse API ici, collez-la dans votre projet, et Retrofit gérera la désérialisation automatiquement.

Quelle est la différence entre @SerializedName et @SerialName en Kotlin ?

@SerializedName est pour Gson et mappe une clé JSON à un nom de propriété Kotlin. @SerialName est l'équivalent kotlinx.serialization. Utilisez celui qui correspond à votre bibliothèque JSON. Les deux permettent que des clés JSON comme user_name soient mappées à une propriété Kotlin nommée userName.

Mon JSON est-il envoyé à un serveur ?

Non. La génération de data classes s'exécute entièrement dans votre navigateur. Votre JSON ne quitte jamais votre machine.

Les types nullable dans les data classes Kotlin ?

Activez Nullable Types pour générer String?, Int?, etc. C'est utile quand un champ JSON peut être absent ou null. La sécurité null de Kotlin signifie que vous obtiendrez une erreur de compilation si vous oubliez de gérer ces cas.

Outils connexes

Pour JSON en Kotlin, voir kotlinx.serialization et Gson. Pour JSON, voir la spécification JSON et RFC 8259. Pour une vue d'ensemble, voir MDN.