JSON в класс Java

Пример вывода: Jackson + Lombok

Ввод:

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

Вывод:

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

Сопоставление типов

Выбор между обёрточным и примитивным типом

• Примитивный тип (int, long, boolean), не может быть null, эффективен, без автоупаковки.
• Обёрточный тип (Integer, Long, Boolean), допускает null; необходим, если поле может отсутствовать или быть null в JSON.

По умолчанию генератор использует обёрточный тип для всего, что считается допускающим null, и примитивный, в остальных случаях.

Jackson и Gson

Частые ошибки

• Использование примитивных типов для полей, допускающих null. int не может быть null; Jackson выбросит ошибку, если в JSON окажется "age": null. Используйте Integer.
• Отсутствие модулей для дат. Jackson требует jackson-datatype-jsr310 для Instant/LocalDate. Без него даты откатываются к String или к значениям long в формате epoch.
• Совместное использование обёрточных типов в несвязанных классах. Если в двух JSON-структурах есть вложенный Address, генератор создаст два класса Address. Переименуйте или объедините их вручную.
• Забытый @JsonIgnoreProperties(ignoreUnknown = true). Строгий Jackson выбрасывает ошибку на неизвестных свойствах; добавьте эту аннотацию (или настройте её глобально) для терпимой десериализации.