Cole um JSON de exemplo e receba classes Java ou records que o Jackson consegue desserializar na hora. Objetos aninhados viram classes adicionais no mesmo arquivo, e arrays viram List<T>.
Use para os DTOs que você digitaria à mão no Spring Boot: tipos de resposta para clients RestTemplate, WebClient ou Feign, ou request bodies para APIs de terceiros. No Java 16+ dá para gerar records, e se a sua codebase já usa Lombok, a opção Lombok mantém a saída no mesmo estilo.
Nome do tipo. Só a primeira classe é public, então use o mesmo nome do arquivo.class (com getters/setters) ou record em Estilo.class, marque Lombok para trocar os getters/setters por @Data, @NoArgsConstructor e @AllArgsConstructor..java e adicione a declaração de package.{
"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;
}
}
Chaves snake_case como full_name são mapeadas para um campo fullName via @JsonProperty. private é keyword do Java, então o campo virou private_, enquanto os accessors continuam getPrivate()/setPrivate(), e o objeto owner foi separado numa classe Owner no mesmo arquivo.
class comum com getters/setters, ou um record imutável.@Data, @NoArgsConstructor, @AllArgsConstructor mais os imports e remove o código dos accessors.@JsonProperty só é adicionado onde o nome do campo difere da chave JSON, junto com o import.Integer, Long, Double, Boolean), então o null do JSON cabe sem trabalho extra.Long; valores de tipos misturados viram Object.class ou default, ganham um _ no final; chaves que começam com dígito ganham o prefixo n.// Root: List<RootItem> mais a classe do elemento.Cole a resposta de exemplo da documentação de uma API de pagamento, mapas ou mensageria e passe a classe gerada para restTemplate.getForObject(url, PaymentResponse.class). Quanto mais profundo o aninhamento, mais campos você deixa de esquecer em comparação com escrever à mão.
Para respostas que você só lê, um record é mais curto e não tem setters; o Jackson 2.12+ desserializa pelo construtor canônico do record.
Num projeto legado em que só existem arquivos JSON de fixture, passe uma fixture para ver o layout dos campos e ter um primeiro rascunho do DTO.
null no wrapper type; nada o marca como opcional. Adicione @NotNull ou algo parecido você mesmo se valida valores obrigatórios.@JsonIgnoreProperties(ignoreUnknown = true) ou desativar o FAIL_ON_UNKNOWN_PROPERTIES.String. Mapeá-las para LocalDateTime ou OffsetDateTime exige o módulo jackson-datatype-jsr310.record esconde o checkbox do Lombok, já que records não precisam dele.public. Separe em arquivos próprios se outros packages precisarem delas.getXxx e não isXxx?O tipo do campo é o wrapper Boolean, não o primitivo boolean. Há muito tempo o Jackson só reconhece accessors isXxx para boolean primitivo, então é usado getXxx para a propriedade fazer bind do mesmo jeito em qualquer versão do Jackson.
record mantém o @JsonProperty?Sim, componentes renomeados são escritos como @JsonProperty("full_name") String fullName. O Jackson 2.12 ou mais novo os preenche pelo construtor canônico.
spring.jackson.property-naming-strategy=SNAKE_CASE, posso apagar as anotações?Com uma estratégia SNAKE_CASE global, full_name ↔ fullName é mapeado sem anotações. Nomes alterados por causa de keywords, como private_, não são cobertos pela estratégia, então mantenha essas anotações.
O Gson ignora o @JsonProperty. Troque por @SerializedName na saída em class e a mesma estrutura funciona com o Gson; records são suportados a partir do Gson 2.10.