¡Convierte clases de Java a JSON!

¡Pega código Java (class·record) y obtén un JSON de ejemplo! Compatible con Jackson @JsonProperty, @JsonIgnore, Lombok. Útil para documentar APIs y cuerpos de petición de prueba (mock request body).
Java
Resultado
 

¡Convierte clases de Java a JSON!

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.

Cómo usar

  1. Pega el código del DTO tal cual. Los imports, las anotaciones de Lombok, los constructores y los métodos pueden quedarse.
  2. Incluye en la misma entrada las declaraciones anidadas static class, record y enum para que los campos que las referencian se rellenen con su estructura.
  3. Con 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.
  4. Copia la salida en @Schema(example = ...), en un snippet de REST Docs o en el body de una petición de MockMvc.

Ejemplo

Entrada (Java)
@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) {}
}
Salida (JSON)
{
  "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.

Funciones compatibles

  • Los nombres de campo pasan a ser claves, sobrescritos por @JsonProperty("x") o @JsonProperty(value = "x").
  • Se excluyen: los campos con @JsonIgnore, las claves listadas en un @JsonIgnoreProperties({...}) a nivel de clase y los campos static o transient.
  • Admite componentes de record de Java 16+, declaraciones static class anidadas y campos heredados mediante extends (primero los campos del padre).
  • Los campos enum contienen la primera constante como cadena, o la constante indicada en el inicializador del campo; @JsonProperty("x") en una constante cambia la cadena a x.
  • Las fechas siguen la salida por defecto de Jackson en Spring Boot: 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.
  • Los wrappers numéricos como 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".

Casos de uso

Rellenar los ejemplos de springdoc / Swagger

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.

Bodies de petición para tests con MockMvc o RestAssured

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.

Compartir la forma de una respuesta con el frontend

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.

Notas y limitaciones

  • Los inicializadores de campo se usan cuando son un literal (= "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.
  • Los getters sin un campo correspondiente, como 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).
  • No se aplican las reglas de nombres globales (@JsonNaming(SnakeCaseStrategy.class), spring.jackson.property-naming-strategy) ni los patrones de fecha de @JsonFormat.
  • Los métodos @JsonValue de los enums no se evalúan, así que esos enums siguen mostrando la constante (o su nombre @JsonProperty).
  • Los campos 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.

Preguntas frecuentes

¿Funciona cuando @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.

¿Por qué 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].

¿Puedo pegar una entidad JPA?

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.

¿Y si @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.