¡Convierte JSON en class de Java!

¡Introduce JSON para generar código class de Java, incluidos los objetos anidados! Compatible con Jackson @JsonProperty, Lombok. Spring Boot JPA @Entity · MongoDB @Document: en las pestañas de arriba.
JSON
Resultado
 

¡Convierte JSON en class de Java!

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.

Cómo usar

  1. Pega el JSON de la respuesta de la API en el cuadro de entrada.
  2. Escribe el nombre del DTO en Nombre del tipo. Solo la primera clase es public, así que haz que coincida con el nombre del archivo.
  3. Elige class (con getters/setters) o record en Estilo.
  4. Con class, marca Lombok para sustituir los getters/setters por @Data, @NoArgsConstructor y @AllArgsConstructor.
  5. Pega el resultado en un archivo .java y añade tu declaración de package.

Ejemplo

Entrada (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
Salida (Java · class)
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.

Funciones compatibles

  • Dos estilos de salida: una class normal con getters/setters o un record inmutable.
  • Opción Lombok (solo con el estilo class): añade @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.
  • Todos los campos usan un tipo wrapper (Integer, Long, Double, Boolean), así que un null de JSON encaja sin trabajo extra.
  • Los enteros fuera del rango de 32 bits pasan a Long; los valores de tipos mixtos pasan a Object.
  • Las claves que son palabras reservadas como class o default reciben un _ al final; las que empiezan por un dígito reciben el prefijo n.
  • Java no tiene alias de tipos, así que un array de nivel superior produce un comentario // Root: List<RootItem> más la clase del elemento.

Casos de uso

DTOs para APIs de terceros en Spring Boot

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.

Modelos de respuesta de solo lectura como records

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.

Recuperar un modelo a partir de fixtures de prueba

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.

Notas y limitaciones

  • Un campo que falta en algunos elementos simplemente llega como null en el tipo wrapper; nada lo marca como opcional. Añade tú @NotNull o similar si validas valores obligatorios.
  • Con la configuración por defecto, Jackson lanza una excepción ante claves desconocidas. Si la API puede añadir campos, plantéate @JsonIgnoreProperties(ignoreUnknown = true) o desactivar FAIL_ON_UNKNOWN_PROPERTIES.
  • Las cadenas de fecha salen como String. Mapearlas a LocalDateTime u OffsetDateTime requiere el módulo jackson-datatype-jsr310.
  • Al elegir record se oculta la casilla de Lombok, ya que los records no lo necesitan.
  • Las clases anidadas son clases package-private en el mismo archivo, no public. Sepáralas en archivos propios si otros packages las necesitan.

Preguntas frecuentes

¿Por qué el getter de un campo booleano es 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.

¿La salida 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.

Si configuro 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.

¿Puedo usar la salida con Gson?

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.