¡Convierte JSON a esquema de Spring Boot JPA!

¡Introduce JSON y conviértelo en esquema de Spring Boot JPA! Compatible con Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok.
JSON
Resultado
 

¡Convierte JSON a esquema de Spring Boot JPA!

Convierte JSON en una clase @Entity para Spring Data JPA sobre Spring Boot 3. El archivo Java único incluye los imports de jakarta.persistence y jakarta.validation, una clave primaria @Id, un campo private por clave, @Getter, @Setter y @FieldNameConstants de Lombok, y @NotEmpty/@NotNull de Bean Validation.

Está pensado para el trabajo de backend con Spring Boot en el que necesitas rápido una entidad mapeada a una tabla, partiendo de un JSON de ejemplo de un partner de integración o de una especificación de pantalla.

Cómo usar

  1. Pega un registro como objeto o varios como array. Los campos que faltan en algún registro no reciben anotación de validación.
  2. Escribe el nombre de la clase de entidad en Nombre del modelo (por defecto MyModel). Su forma en minúsculas también se usa al final del package (com.hello.world.reservation).
  3. Cambia la línea package por el package de tu proyecto, guárdalo como Reservation.java y crea un repositorio que extienda JpaRepository<Reservation, Long>.

Ejemplo

Entrada (JSON)
{
  "guest_name": "Hana Lee",
  "room_no": 1204,
  "nights": 3,
  "rate": 149.5,
  "breakfast": true,
  "check_in": "2024-08-09T15:00:00"
}
Salida (Spring Data JPA)
package com.hello.world.reservation;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.NotNull;

import java.time.LocalDateTime;

import lombok.Getter;
import lombok.Setter;
import lombok.experimental.FieldNameConstants;

@Entity
@FieldNameConstants
@Getter
@Setter
public class Reservation {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @NotEmpty()
    @Column(name = "guest_name")
    private String guestName;

    @NotNull()
    @Column(name = "room_no")
    private Long roomNo;

    @NotNull()
    private Long nights;

    @NotNull()
    private Double rate;

    @NotNull()
    private Boolean breakfast;

    @NotNull()
    @Column(name = "check_in")
    private LocalDateTime checkIn;
}

Los enteros como room_no y nights pasaron a Long, rate a Double y check_in a LocalDateTime. Cada clave snake_case recibe @Column(name = "..."), y como todos los valores están rellenos, el campo String guestName recibe @NotEmpty() y los demás @NotNull().

Funciones compatibles

  • Tipos Java: enteros → Long, decimales → Double, booleanos → Boolean, YYYY-MM-DD → LocalDate, fechas con hora → LocalDateTime, otras cadenas (incluidas las que solo tienen dígitos) → String.
  • Los objetos pasan a Map<String, Object> y los arrays a List<...>, ambos anotados con @JdbcTypeCode(SqlTypes.JSON) para que Hibernate 6 los guarde en una columna JSON.
  • @Column(name = "guest_name") conserva la clave original como nombre de columna siempre que el nombre del campo Java difiere; las claves que son palabras reservadas de Java, como class, pasan a class_.
  • La clave primaria sigue a tu JSON: sin id o con un id entero se genera @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, y con un id de cadena, un @Id private String id simple.
  • Los campos siempre presentes reciben @NotEmpty() cuando son cadenas no vacías y @NotNull() en los demás casos, ya que @NotEmpty solo se aplica a cadenas y colecciones.
  • @FieldNameConstants de Lombok genera constantes de nombres como Reservation.Fields.guestName.

Casos de uso

Batch jobs que guardan datos de APIs externas

Cuando hay que traer y guardar periódicamente reservas o pedidos de otro sistema, una respuesta JSON te da la entidad, y el esqueleto del batch job alrededor de saveAll() sale enseguida.

Tablas de desarrollo mediante `ddl-auto`

Con spring.jpa.hibernate.ddl-auto=update activado en local, Hibernate crea la tabla a partir de la entidad generada, así que puedes cargar datos para trabajar en la UI de inmediato.

Notas y limitaciones

  • Los imports apuntan a Jakarta EE (Spring Boot 3, Hibernate 6). En Spring Boot 2, vuelve a cambiar jakarta. por javax. y sustituye @JdbcTypeCode por un converter, ya que no existe en Hibernate 5.
  • 149.0 en JSON se parsea como el mismo número que 149, así que pasa a Long. Un campo decimal necesita un valor con parte fraccionaria en el ejemplo para salir como Double, y para dinero es mejor BigDecimal.
  • Los timestamps con offset, como 2024-08-09T15:00:00+09:00, pierden el offset en LocalDateTime. Usa OffsetDateTime o Instant cuando importe el instante exacto.
  • Las columnas JSON requieren una base de datos que las tenga (MySQL 5.7+, PostgreSQL, H2 2.x). Para relaciones reales, sustituye el Map por una clase @Embedded o una asociación @OneToMany.

Preguntas frecuentes

¿Por qué poner @Column(name = ...) en campos que Spring mapearía a snake_case de todos modos?

La estrategia de nombres por defecto de Spring Boot convierte guestName en guest_name, pero eso deja de funcionar en cuanto una clave no es snake_case simple o se cambia la estrategia. El nombre explícito mantiene el mapeo correcto con cualquier configuración.

¿Se aplica @NotNull al guardar?

Con spring-boot-starter-validation (Hibernate Validator) en el classpath, Hibernate ejecuta Bean Validation justo antes de persist y update y lanza ConstraintViolationException. Sin él, las anotaciones se ignoran.

¿Para qué sirve @FieldNameConstants?

Lombok genera constantes de cadena como Reservation.Fields.checkIn. Úsalas en Sort.by(Reservation.Fields.checkIn) o en consultas Specification/Criteria en lugar de literales de cadena, para que renombrar un campo rompa la compilación y no la consulta.