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.
Nombre del modelo (por defecto MyModel). Su forma en minúsculas también se usa al final del package (com.hello.world.reservation).package por el package de tu proyecto, guárdalo como Reservation.java y crea un repositorio que extienda JpaRepository<Reservation, Long>.{
"guest_name": "Hana Lee",
"room_no": 1204,
"nights": 3,
"rate": 149.5,
"breakfast": true,
"check_in": "2024-08-09T15:00:00"
}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().
Long, decimales → Double, booleanos → Boolean, YYYY-MM-DD → LocalDate, fechas con hora → LocalDateTime, otras cadenas (incluidas las que solo tienen dígitos) → String.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_.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.@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.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.
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.
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.2024-08-09T15:00:00+09:00, pierden el offset en LocalDateTime. Usa OffsetDateTime o Instant cuando importe el instante exacto.Map por una clase @Embedded o una asociación @OneToMany.@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.
@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.
@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.