Pega un JSON de ejemplo y obtén clases Java o records que Jackson puede deserializar directamente. Los objetos anidados se convierten en clases adicionales en el mismo archivo, y los arrays en List<T>.
Úsalo para los DTOs que si no tendrías que teclear a mano en Spring Boot: tipos de respuesta para clientes RestTemplate, WebClient o Feign, o bodies de petición para APIs de terceros. En Java 16+ puedes generar records, y si tu código ya usa Lombok, la opción Lombok mantiene la salida en el mismo estilo.
Nombre del tipo. Solo la primera clase es public, así que haz que coincida con el nombre del archivo.class (con getters/setters) o record en Estilo.class, marca Lombok para sustituir los getters/setters por @Data, @NoArgsConstructor y @AllArgsConstructor..java y añade tu declaración 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;
}
}
Las claves snake_case como full_name se mapean a un campo fullName mediante @JsonProperty. private es una palabra reservada de Java, así que el campo pasó a private_ mientras sus accessors se quedan como getPrivate()/setPrivate(), y el objeto owner se separó en una clase Owner en el mismo archivo.
class normal con getters/setters o un record inmutable.@Data, @NoArgsConstructor, @AllArgsConstructor con sus imports y elimina el código de los accessors.@JsonProperty se añade solo donde el nombre del campo difiere de la clave JSON, junto con su import.Integer, Long, Double, Boolean), así que un null de JSON encaja sin trabajo extra.Long; los valores de tipos mixtos pasan a Object.class o default reciben un _ al final; las que empiezan por un dígito reciben el prefijo n.// Root: List<RootItem> más la clase del elemento.Pega la respuesta de ejemplo de la documentación de una API de pagos, mapas o mensajería y pasa la clase generada a restTemplate.getForObject(url, PaymentResponse.class). Cuanto más profundo es el anidamiento, más campos te ahorras olvidar en comparación con escribirlo a mano.
Para respuestas que solo lees, un record es más corto y no tiene setters; Jackson 2.12+ deserializa a través del constructor canónico del record.
En un proyecto legacy donde solo existen archivos JSON de fixtures, pasa uno por la herramienta para ver la disposición de los campos y obtener un primer borrador del DTO.
null en el tipo wrapper; nada lo marca como opcional. Añade tú @NotNull o similar si validas valores obligatorios.@JsonIgnoreProperties(ignoreUnknown = true) o desactivar FAIL_ON_UNKNOWN_PROPERTIES.String. Mapearlas a LocalDateTime u OffsetDateTime requiere el módulo jackson-datatype-jsr310.record se oculta la casilla de Lombok, ya que los records no lo necesitan.public. Sepáralas en archivos propios si otros packages las necesitan.getXxx y no isXxx?El tipo del campo es el wrapper Boolean, no el primitivo boolean. Jackson reconoce desde hace tiempo los accessors isXxx solo para el primitivo boolean, así que se usa getXxx para que la propiedad se vincule igual en cualquier versión de Jackson.
record conserva @JsonProperty?Sí, los componentes renombrados se escriben como @JsonProperty("full_name") String fullName. Jackson 2.12 o posterior los rellena a través del constructor canónico.
spring.jackson.property-naming-strategy=SNAKE_CASE, ¿puedo borrar las anotaciones?Con una estrategia SNAKE_CASE global, full_name ↔ fullName se mapean sin anotaciones. Los nombres cambiados por palabras reservadas, como private_, no los cubre la estrategia, así que mantén esas anotaciones.
Gson ignora @JsonProperty. Sustitúyelo por @SerializedName en la salida de clases y la misma estructura funciona con Gson; los records están soportados desde Gson 2.10.