Pásale el código fuente de un DTO, POJO o record de Java y obtén el JSON que muy probablemente produciría la configuración de Jackson por defecto de Spring Boot. Las claves salen de los campos declarados, aplicando @JsonProperty, @JsonIgnore, @JsonIgnoreProperties y las exclusiones de static/transient.
Úsalo para generar un ejemplo de Swagger o un payload de muestra para el frontend a partir del DTO de petición o respuesta de un controller, o simplemente para comprobar qué claves emitirá una clase con @Data de Lombok.
static class, record y enum para que los campos que las referencian se rellenen con su estructura.Tipo raíz en Automático, se elige la clase que ninguna otra usa como tipo de campo. Cuando las entidades se referencian entre sí, elige la que quieras de la lista.@Schema(example = ...), en un snippet de REST Docs o en el body de una petición de MockMvc.@Data
@JsonIgnoreProperties({"password"})
public class MemberResponse {
private Long memberId;
@JsonProperty("nick_name")
private String nickname;
private String password;
private Grade grade = Grade.SILVER;
private LocalDate birthDate;
private List<Address> addresses;
private static final long serialVersionUID = 1L;
public enum Grade { BRONZE, SILVER, GOLD }
public record Address(String zipCode, String city, boolean primary) {}
}{
"memberId": 0,
"nick_name": "",
"grade": "SILVER",
"birthDate": "1970-01-01",
"addresses": [
{
"zipCode": "",
"city": "",
"primary": false
}
]
}password se elimina por el @JsonIgnoreProperties({"password"}) a nivel de clase, y el serialVersionUID static final nunca aparece. Se lee el inicializador Grade.SILVER, así que grade es "SILVER" en lugar de la primera constante del enum. El record Address anidado se expande en un array de objetos.
@JsonProperty("x") o @JsonProperty(value = "x").@JsonIgnore, las claves listadas en un @JsonIgnoreProperties({...}) a nivel de clase y los campos static o transient.record de Java 16+, declaraciones static class anidadas y campos heredados mediante extends (primero los campos del padre).@JsonProperty("x") en una constante cambia la cadena a x.LocalDateTime → 1970-01-01T00:00:00, LocalDate → 1970-01-01, Instant/OffsetDateTime/ZonedDateTime → cadena ISO terminada en Z, java.util.Date/Timestamp → 1970-01-01T00:00:00.000+00:00.BigDecimal y Long pasan a 0, Optional<T> se desenvuelve a T, byte[] pasa a una cadena Base64, y UUID y ObjectId de MongoDB reciben valores con el formato correcto.List, Set y los arrays reciben un elemento de ejemplo; un map como Map<Long, V> con clave numérica usa "0", y si no, "key".Los valores example escritos a mano se desfasan cada vez que se añade un campo a un DTO. Genera el JSON a partir del código del DTO y pule los valores desde ahí, para que no falte ni esté mal escrita ninguna clave.
Crea el JSON de la petición directamente a partir del DTO @RequestBody y pégalo en un text block (""") en tu test. Las claves renombradas con @JsonProperty ya están aplicadas, igual que en el binding real.
Los desarrolladores de frontend que no leen el código del backend reciben directamente la estructura JSON del endpoint, en lugar de tener que interpretar una clase Java.
= "guest", = 100, = true) o una constante de enum (= Grade.SILVER); cualquier otra cosa, como new ArrayList<>() o una llamada a un método, recurre al placeholder del tipo.getFullName() o boolean isVip(), se añaden como propiedades igual que hace Jackson, respetando @JsonIgnore/@JsonProperty en ese getter. Al revés, se asume que un campo private sin getter es visible (como con @Getter/@Data de Lombok).@JsonNaming(SnakeCaseStrategy.class), spring.jackson.property-naming-strategy) ni los patrones de fecha de @JsonFormat.@JsonValue de los enums no se evalúan, así que esos enums siguen mostrando la constante (o su nombre @JsonProperty).Page<T>/Slice<T> de Spring Data se simplifican a un array de elementos; la serialización real de Page es un objeto con content, pageable y más.@Data o @Getter de Lombok generan los accessors?Sí. Las claves se construyen a partir de los campos declarados, así que los getters y setters que Lombok genera en tiempo de compilación no necesitan estar en el código fuente.
LocalDateTime es una cadena y no un array de números?Spring Boot registra jackson-datatype-jsr310 y desactiva WRITE_DATES_AS_TIMESTAMPS por defecto, lo que produce cadenas ISO; el ejemplo sigue ese comportamiento por defecto. Un ObjectMapper de Jackson sin configurar puede escribir en cambio un array como [1970,1,1,0,0].
Las entidades tienen la misma estructura de campos, así que se parsean bien. Las asociaciones bidireccionales como @OneToMany entrarían en bucle, así que se expanden una vez y luego se cortan con null o un array vacío. También hay una página dedicada de Spring Boot JPA → JSON.
@JsonIgnore está en un setter o en el getter de un campo existente?Las anotaciones en la declaración de un campo siempre se aplican, y las de un getter solo cuando no existe un campo con ese nombre. @JsonIgnore en un setter, o en el getter de un campo declarado, no se aplica, así que muévelo al campo para ver su efecto.