Générateur de classes Java à partir de JSON
Générez des définitions de classes POJO Java à partir d'objets JSON. Cela produit des classes annotées pour Jackson, incluant des champs avec l'annotation @JsonProperty, des getters, des setters et des types Java appropriés déduits des valeurs JSON.
Génère des POJO Java avec des annotations @JsonProperty pour Jackson.
Associe les types JSON aux types primitifs et objets Java : String, Integer, Double, Boolean, List<T>.
Crée des définitions de classes internes imbriquées pour les objets JSON imbriqués.
Génère des getters et des setters respectant la convention de nommage JavaBeans.
Prêt à être utilisé avec Jackson ObjectMapper pour la désérialisation JSON.
Mode d'emploi
Collez un objet JSON dans le champ de saisie.
Le générateur produit une classe Java avec des champs annotés.
Copiez la classe dans votre projet Java.
Utilisez Jackson ObjectMapper pour désérialiser du JSON en une instance de votre classe.
Développement d'API Java
- Désérialiser des réponses REST avec Spring RestTemplate
- Typage des DTO Jackson pour les contrôleurs Spring Boot
- Analyser une configuration JSON avec Jackson
Java d'entreprise
- Mapper les charges utiles JSON dans les consommateurs Kafka
- Définir des objets de transfert de données pour les microservices
- Analyser les charges utiles de webhook dans les services Java
Écosystème Java
- Spring Boot
- Jackson
- Quarkus
- Micronaut
- Jakarta EE
Ajoutez `@JsonIgnoreProperties(ignoreUnknown = true)` au niveau de la classe pour gérer correctement les réponses JSON contenant des champs supplémentaires non définis dans votre POJO.
Utilisez Integer, Double et Boolean (types enveloppes) plutôt que int, double et boolean pour gérer correctement les valeurs JSON nulles.
Pour les champs pouvant être nuls en JSON, veillez à utiliser des types « wrapper » (types objets correspondants) ; les types primitifs comme `int` ne peuvent pas représenter la valeur `null` en Java.
Ajoutez `@JsonIgnoreProperties(ignoreUnknown = true)` à tous les POJO de réponse d'API pour éviter les échecs lorsque les API ajoutent de nouveaux champs.
Utilisez des types enveloppes (Integer, Double, Boolean) plutôt que des types primitifs pour tous les champs susceptibles d'être nuls dans le JSON.
Envisagez d'ajouter l'annotation Lombok `@Data` pour éliminer le code répétitif des méthodes getter, setter, `equals`, `hashCode` et `toString`.
Foire aux questions
Trouvez des réponses aux questions fréquentes sur nos outils et services.
Comprendre JSON vers classe Java
Java demeure l'un des langages les plus utilisés pour le développement backend en entreprise, et Jackson s'impose comme la bibliothèque de sérialisation JSON dominante au sein de l'écosystème Java. Spring Boot configure automatiquement un `ObjectMapper` de Jackson pour tous les contrôleurs REST, faisant ainsi des POJO (*Plain Old Java Objects*) annotés avec Jackson la norme pour définir les types de corps de requête et de réponse dans les applications Spring. Quarkus et Micronaut, des frameworks Java natifs pour le cloud plus récents, prennent également en charge Jackson comme bibliothèque de liaison JSON de premier plan. Rédiger manuellement des classes Java annotées avec Jackson pour chaque charge utile d'API ou structure de configuration JSON est une tâche répétitive impliquant la création de champs, d'annotations, de getters, de setters et de constructeurs — autant d'éléments qui peuvent être générés automatiquement à partir d'un exemple JSON.
L'annotation `@JsonProperty` de Jackson associe un champ Java à une clé JSON spécifique, permettant ainsi aux conventions de nommage `camelCase` de Java de coexister avec des API JSON utilisant `camelCase`, `snake_case` ou d'autres conventions. Lorsqu'un objet JSON contient une clé telle que `user_id`, le champ Java correspondant peut être nommé `userId` et annoté avec `@JsonProperty("user_id")` ; cela permet de conserver un nommage Java idiomatique tout en assurant une désérialisation correcte à partir de la clé JSON. L'annotation `@JsonIgnoreProperties(ignoreUnknown = true)`, appliquée au niveau de la classe, constitue une mesure défensive importante : elle prévient les échecs de désérialisation lorsque l'API ajoute de nouveaux champs non encore définis dans la classe Java, ce qui est essentiel pour garantir la rétrocompatibilité des clients API à long terme.
Le système de types de Java impose une distinction claire entre les types primitifs (int, double, boolean) et leurs équivalents objets « wrappés » ou « encapsulés » (Integer, Double, Boolean). Cette distinction est cruciale pour la désérialisation JSON, car la valeur null en JSON correspond à une référence null en Java — or, null ne peut pas être affecté à un type primitif. Lorsqu'un champ JSON peut prendre une valeur null, le champ Java correspondant doit utiliser un type objet encapsulé afin d'éviter une NullPointerException lors de la désérialisation. Le générateur utilise ces types objets pour tous les champs présentant des valeurs non nulles dans l'exemple JSON, par anticipation de la présence éventuelle de valeurs nulles dans les données de production. Les types primitifs ne doivent être utilisés que pour les champs dont la non-nullité est garantie.
Ce générateur de classes Java à partir de JSON produit des classes POJO standard annotées pour Jackson (avec `@JsonProperty`), dotées de champs privés utilisant les types « wrapper » Java appropriés et de méthodes d'accès (getters et setters) conformes à la convention JavaBeans. Les objets JSON imbriqués sont traduits en classes statiques internes à la classe racine, regroupant ainsi tous les types associés dans une même unité de compilation tout en préservant l'encapsulation. Le type `List<T>` est utilisé pour les tableaux JSON, avec le type d'élément adéquat. Le code généré peut être intégré directement dans un projet Java et compilé immédiatement, sous réserve de disposer de la dépendance Jackson Databind. Pour les projets souhaitant réduire davantage le code répétitif (« boilerplate »), les méthodes d'accès peuvent être remplacées par des annotations Lombok (`@Data`, `@Getter` ou `@Setter`) sans modifier le comportement de sérialisation sous-jacent.