Accueil › Java › JSON et sérialisation
JSON et sérialisation
Entrées/sorties et fichiersintermediaire
Pour lire et écrire du JSON, la bibliothèque Jackson (com.fasterxml.jackson) est le standard de fait dans l'écosystème Java. Tout passe par un ObjectMapper, à créer une seule fois et à réutiliser :
ObjectMapper mapper = new ObjectMapper();
Produit produit = mapper.readValue(json, Produit.class); // JSON -> objet
String json2 = mapper.writeValueAsString(produit); // objet -> JSON
mapper.writeValue(cheminExport.toFile(), produit); // objet -> fichier JSON
Un record se mappe nativement, sans annotation, tant que son constructeur canonique est le seul constructeur :
record Produit(String nom, double prix, int quantiteStock) {}
Pour un type générique (List<Produit>), readValue a besoin d'une indication supplémentaire via TypeReference, car l'effacement de type ne laisse rien à l'exécution :
List<Produit> produits = mapper.readValue(json, new TypeReference<List<Produit>>() {});
Le JDK possède aussi un mécanisme de sérialisation natif et bien plus ancien : Serializable, ObjectOutputStream/ObjectInputStream. Il n'a jamais été supprimé, mais désérialiser des données non fiables avec ce mécanisme est un risque de sécurité reconnu : le flux peut forcer l'instanciation de classes arbitraires du classpath. En 2026, pour persister ou échanger des données, JSON (ou un format binaire à schéma explicite comme Protobuf) est le choix par défaut ; la sérialisation Java native se réserve à des cas internes étroits, encadrés par des filtres.
Les termes à connaître
- ObjectMapper
Classe centrale de la bibliothèque Jackson, point d'entrée pour convertir des objets Java en JSON (
writeValue,writeValueAsString) et inversement (readValue). Une même instance est thread-safe et coûteuse à créer : on en garde une seule, partagée, par application.- TypeReference
Classe utilitaire de Jackson à sous-classer en anonyme (
new TypeReference<List<Produit>>() {}) pour indiquer àreadValueun type générique précis, que l'effacement de type empêcherait sinon de connaître à l'exécution.- JavaTimeModule
Module Jackson (dépendance
jackson-datatype-jsr310) qui apprend àObjectMapperà sérialiser et désérialiser les types dejava.time(LocalDate,Instant...). Sans lui, ces types ne sont pas correctement pris en charge.- Serializable
Interface marqueur (aucune méthode) de
java.io: l'implémenter autorise une classe à être convertie en flux d'octets parObjectOutputStream, puis reconstruite parObjectInputStream. Mécanisme natif de sérialisation binaire du JDK, distinct du JSON.- serialVersionUID
Champ
static final longqu'une classeSerializabledéclare explicitement pour contrôler la compatibilité entre versions : une désérialisation échoue si l'UID du flux ne correspond pas à celui de la classe chargée, plutôt que de tenter une correspondance approximative.- transient
Modificateur qui exclut un champ de la sérialisation Java native (
Serializable). Le champ redevient à sa valeur par défaut (null,0,false...) après désérialisation, au lieu d'être reconstruit depuis le flux.- ObjectInputFilter
Mécanisme (JEP 290, renforcé par JEP 415) permettant de restreindre les classes qu'un
ObjectInputStreamaccepte de reconstruire, pour limiter le risque d'exécution de code arbitraire lors de la désérialisation de données non fiables.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.