JSON naar Java-klasse

Voorbeelduitvoer: Jackson + Lombok

Invoer:

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

Uitvoer:

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

Typetoewijzing

Kiezen tussen wrapper- en primitief type

• Primitief (int, long, boolean), niet-nullbaar, efficiënt, zonder auto-boxing.
• Wrapper (Integer, Long, Boolean), nullbaar, vereist als het veld in JSON kan ontbreken of null kan zijn.

De generator gebruikt standaard een wrapper-type voor alles wat als nullbaar wordt beschouwd, en anders een primitief type.

Jackson versus Gson

Veelvoorkomende fouten

• Primitieve typen gebruiken voor nullbare velden. int kan niet null zijn; Jackson gooit een fout als de JSON "age": null bevat. Gebruik Integer.
• Ontbrekende datummodules. Jackson heeft jackson-datatype-jsr310 nodig voor Instant/LocalDate. Zonder deze module vallen datums terug op String of epoch-longs.
• Wrapper-typen delen tussen niet-gerelateerde klassen. Als twee JSON-vormen beide een geneste Address hebben, maakt de generator twee Address-klassen aan. Hernoem of voeg ze handmatig samen.
• @JsonIgnoreProperties(ignoreUnknown = true) vergeten. Strikte Jackson gooit een fout bij onbekende eigenschappen; voeg deze annotatie toe (of configureer die globaal) voor tolerante deserialisatie.