JSON na klasę Java

Przykładowe wyjście: Jackson + Lombok

Wejście:

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

Wyjście:

@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;
}

Mapowanie typów

Wybór między typem opakowującym a prymitywnym

• Typ prymitywny (int, long, boolean), nie może być null, wydajny, bez auto-boxingu.
• Typ opakowujący (Integer, Long, Boolean), może być null; wymagany, gdy pole może być nieobecne lub null w JSON.

Domyślnie generator stosuje typ opakowujący dla wszystkiego, co uznaje za mogące być null, a w pozostałych przypadkach typ prymitywny.

Jackson kontra Gson

Częste błędy

• Używanie typów prymitywnych dla pól mogących być null. int nie może być null; Jackson zgłosi błąd, jeśli JSON zawiera "age": null. Użyj Integer.
• Brak modułów dat. Jackson wymaga jackson-datatype-jsr310 dla Instant/LocalDate. Bez niego daty wracają do String lub wartości long w formacie epoch.
• Współdzielenie typów opakowujących między niepowiązanymi klasami. Jeśli dwie struktury JSON mają zagnieżdżony Address, generator tworzy dwie klasy Address. Zmień nazwy lub scal je ręcznie.
• Pominięcie @JsonIgnoreProperties(ignoreUnknown = true). Rygorystyczny Jackson zgłasza błąd przy nieznanych właściwościach; dodaj tę anotację (lub skonfiguruj ją globalnie), aby uzyskać tolerancyjną deserializację.