Jackson pour Java : guide complet avec exemples

Qu'est-ce que Jackson et pourquoi en a-t-on besoin ?

\n\n

Jackson est une bibliothèque puissante et haute performance pour Java, conçue pour le traitement de données au format JSON (JavaScript Object Notation). Dans le développement moderne d'applications Java, JSON est devenu le standard de facto pour l'échange de données entre le client et le serveur, en particulier dans les services web RESTful et l'architecture de microservices. Jackson résout trois tâches principales :

\n\n

\n
• Sérialisation (Serialization) — conversion d'objets Java en chaîne JSON.
\n
• Désérialisation (Deserialization) — conversion d'une chaîne JSON en objets Java.
\n
• Manipulation d'arbre (Tree Model) — travail avec JSON comme une structure arborescente de nœuds (JsonNode).
\n

\n\n

La bibliothèque se distingue par sa grande vitesse, sa flexibilité de configuration et son large support d'annotations. Jackson est utilisé par des géants tels que Spring Framework (via le module spring-web), Play Framework et de nombreuses autres solutions d'entreprise. Sans Jackson, il est difficile d'imaginer le développement Java moderne, où l'intégration avec des API externes, le travail avec des fichiers de configuration ou le stockage de données dans des bases de données NoSQL sont nécessaires.

\n\n

Installation de Jackson

\n\n

Jackson se compose de plusieurs modules. Les principaux sont :

\n

\n
• jackson-core — le noyau de la bibliothèque (analyseur/générateur de flux).
\n
• jackson-databind — module pour la sérialisation/désérialisation (dépend de core et annotations).
\n
• jackson-annotations — annotations pour configurer le mappage.
\n

\n\n

Pour la plupart des tâches, il suffit d'ajouter jackson-databind, car il inclut transitivement les autres modules.

\n\n

Installation via Maven

\n

Ajoutez dans le fichier pom.xml :

\n

<dependency>\n    <groupId>com.fasterxml.jackson.core</groupId>\n    <artifactId>jackson-databind</artifactId>\n    <version>2.17.1</version> <!-- Vérifiez la version actuelle sur Maven Central -->\n</dependency>

\n\n

Installation via Gradle

\n

Ajoutez dans le fichier build.gradle :

\n

implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.1'

\n\n

Installation via pip ? Non, c'est Java !

\n

Remarque importante : Jackson est une bibliothèque pour Java, pas pour Python. En Python, l'équivalent est le module standard json ou la bibliothèque simplejson. Pour Java, l'installation se fait via des systèmes de gestion de dépendances (Maven, Gradle) ou en téléchargeant les fichiers JAR depuis le site officiel.

\n\n

Démarrage rapide : premier exemple

\n\n

Créons une classe Java simple et apprenons à la transformer en JSON et vice versa.

\n\n

Étape 1 : Créez la classe modèle

\n

import com.fasterxml.jackson.annotation.JsonProperty;\n\npublic class User {\n    private String name;\n    private int age;\n    private String email;\n\n    // Un constructeur par défaut est obligatoire !\n    public User() {}\n\n    public User(String name, int age, String email) {\n        this.name = name;\n        this.age = age;\n        this.email = email;\n    }\n\n    // Les getters et setters sont obligatoires pour Jackson\n    public String getName() { return name; }\n    public void setName(String name) { this.name = name; }\n\n    public int getAge() { return age; }\n    public void setAge(int age) { this.age = age; }\n\n    public String getEmail() { return email; }\n    public void setEmail(String email) { this.email = email; }\n}

\n\n

Étape 2 : Sérialisation et désérialisation

\n

import com.fasterxml.jackson.databind.ObjectMapper;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        // Créez l'objet principal de la bibliothèque\n        ObjectMapper mapper = new ObjectMapper();\n\n        // Créez un objet Java\n        User user = new User("Иван Петров", 30, "ivan@example.co