Вставьте пример JSON и получите классы Java или record, которые Jackson сможет десериализовать сразу. Вложенные объекты становятся дополнительными классами в том же файле, а массивы — List<T>.
Используйте для DTO, которые иначе пришлось бы набирать вручную в Spring Boot: типов ответов для клиентов RestTemplate, WebClient или Feign, или тел запросов к сторонним API. На Java 16+ можно генерировать record, а если в кодовой базе уже используется Lombok, опция Lombok сохранит тот же стиль вывода.
Имя типа. public будет только первый класс, так что согласуйте его с именем файла.Стиль выберите class (с геттерами/сеттерами) или record.class отметьте Lombok, чтобы заменить геттеры/сеттеры на @Data, @NoArgsConstructor и @AllArgsConstructor..java и добавьте объявление пакета.{
"id": 1296269,
"full_name": "octocat/Hello-World",
"private": false,
"stargazers_count": 80,
"owner": { "login": "octocat", "site_admin": false },
"topics": ["api", "demo"]
}import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;
public class Repository {
private Integer id;
@JsonProperty("full_name") private String fullName;
@JsonProperty("private") private Boolean private_;
@JsonProperty("stargazers_count") private Integer stargazersCount;
private Owner owner;
private List<String> topics;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getFullName() {
return fullName;
}
public void setFullName(String fullName) {
this.fullName = fullName;
}
public Boolean getPrivate() {
return private_;
}
public void setPrivate(Boolean private_) {
this.private_ = private_;
}
public Integer getStargazersCount() {
return stargazersCount;
}
public void setStargazersCount(Integer stargazersCount) {
this.stargazersCount = stargazersCount;
}
public Owner getOwner() {
return owner;
}
public void setOwner(Owner owner) {
this.owner = owner;
}
public List<String> getTopics() {
return topics;
}
public void setTopics(List<String> topics) {
this.topics = topics;
}
}
class Owner {
private String login;
@JsonProperty("site_admin") private Boolean siteAdmin;
public String getLogin() {
return login;
}
public void setLogin(String login) {
this.login = login;
}
public Boolean getSiteAdmin() {
return siteAdmin;
}
public void setSiteAdmin(Boolean siteAdmin) {
this.siteAdmin = siteAdmin;
}
}
Ключи в snake_case, такие как full_name, сопоставляются с полем fullName через @JsonProperty. private — ключевое слово Java, поэтому поле стало private_, а аксессоры остались getPrivate()/setPrivate(); объект owner вынесен в класс Owner в том же файле.
class с геттерами/сеттерами или неизменяемый record.@Data, @NoArgsConstructor, @AllArgsConstructor с импортами и убирает код аксессоров.@JsonProperty вместе с импортом добавляется только там, где имя поля отличается от ключа JSON.Integer, Long, Double, Boolean), так что JSON null помещается без дополнительных усилий.Long; значения смешанных типов — Object.class или default получают _ в конце; ключи, начинающиеся с цифры, — префикс n.// Root: List<RootItem> и класс элемента.Вставьте пример ответа из документации API платежей, карт или мессенджера и передайте сгенерированный класс в restTemplate.getForObject(url, PaymentResponse.class). Чем глубже вложенность, тем больше полей вы не пропустите по сравнению с ручным набором.
Для ответов, которые вы только читаете, record короче и не имеет сеттеров; Jackson 2.12+ десериализует через канонический конструктор record.
В legacy-проекте, где остались только JSON-файлы фикстур, подайте фикстуру на вход, чтобы увидеть раскладку полей и получить первый черновик DTO.
null в типе-обёртке; ничто не помечает его как необязательное. Если вы валидируете обязательные значения, добавьте @NotNull или аналог сами.@JsonIgnoreProperties(ignoreUnknown = true) или отключение FAIL_ON_UNKNOWN_PROPERTIES.String. Для отображения в LocalDateTime или OffsetDateTime нужен модуль jackson-datatype-jsr310.record флажок Lombok скрывается, так как records в нём не нуждаются.public. Если они нужны другим пакетам, разнесите их по отдельным файлам.getXxx, а не isXxx?Тип поля — обёртка Boolean, а не примитив boolean. Jackson издавна распознаёт аксессоры isXxx только для примитивного boolean, поэтому используется getXxx, чтобы свойство одинаково привязывалось в любой версии Jackson.
@JsonProperty в выводе record?Да, переименованные компоненты записываются как @JsonProperty("full_name") String fullName. Jackson 2.12 и новее заполняет их через канонический конструктор.
spring.jackson.property-naming-strategy=SNAKE_CASE, можно удалить аннотации?С глобальной стратегией SNAKE_CASE full_name ↔ fullName сопоставляются без аннотаций. Имена, изменённые из-за ключевых слов, вроде private_, стратегией не покрываются, так что эти аннотации оставьте.
Gson игнорирует @JsonProperty. Замените её на @SerializedName в выводе class, и та же структура заработает с Gson; records поддерживаются начиная с Gson 2.10.