Formations — 1 037 leçons en français

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 à readValue un 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 de java.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 par ObjectOutputStream, puis reconstruite par ObjectInputStream. Mécanisme natif de sérialisation binaire du JDK, distinct du JSON.

serialVersionUID

Champ static final long qu'une classe Serializable dé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 ObjectInputStream accepte de reconstruire, pour limiter le risque d'exécution de code arbitraire lors de la désérialisation de données non fiables.

Lire l'explication détaillée et faire le quiz →

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.