JSON vers classe Java

Exemple de sortie : Jackson + Lombok

Entrée :

{ "firstName": "Alice", "age": 30, "address": { "city": "Madrid" } }

Sortie :

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class User {
    @JsonProperty("firstName")
    private String firstName;

    @JsonProperty("age")
    private int age;

    @JsonProperty("address")
    private Address address;
}

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Address {
    @JsonProperty("city")
    private String city;
}

Mappage des types

Choisir entre types enveloppants et primitifs

• Primitif (int, long, boolean), non nul, efficace, pas d’auto-boxing.
• Enveloppé (Integer, Long, Boolean), nullable, requis si le champ peut être absent ou nul dans JSON.

Le générateur par défaut utilise des types enveloppants pour tout ce qui est considéré comme nullable, sinon il utilise des primitifs.

Jackson vs Gson

Erreurs courantes

• Utiliser des types primitifs pour des champs nullable. int ne peut pas être nul ; Jackson lancera une exception si le JSON contient "age": null. Utilisez Integer.
• Modules de date manquants. Jackson a besoin de jackson-datatype-jsr310 pour Instant/LocalDate. Sans cela, les dates retombent sur String ou des longs au format epoch.
• Partage de types enveloppants entre des classes non liées. Si deux formes JSON ont toutes deux une Address imbriquée, le générateur crée deux classes Address. Renommez ou unifiez manuellement.
• Oublier @JsonIgnoreProperties(ignoreUnknown = true). Jackson strict lance une exception sur les propriétés inconnues ; ajoutez cette annotation (ou configurez-la globalement) pour une désérialisation tolérante.