Преобразует JSON в класс @Entity для Spring Data JPA на Spring Boot 3. Один Java-файл включает импорты jakarta.persistence и jakarta.validation, первичный ключ @Id, private-поле на каждый ключ, @Getter, @Setter и @FieldNameConstants из Lombok, а также @NotEmpty/@NotNull из Bean Validation.
Рассчитан на бэкенд-разработку на Spring Boot, когда нужно быстро получить сущность, отображённую на таблицу, отталкиваясь от примера JSON от партнёра по интеграции или из спецификации экрана.
Имя модели (по умолчанию MyModel). Его форма в нижнем регистре также используется в конце пакета (com.hello.world.reservation).package на пакет своего проекта, сохраните как Reservation.java и создайте репозиторий, наследующий 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;
}Целые вроде room_no и nights стали Long, rate — Double, а check_in — LocalDateTime. Каждый ключ в snake_case получает @Column(name = "..."), и поскольку все значения заполнены, поле String guestName получает @NotEmpty(), а остальные — @NotNull().
Long, дробные → Double, булевы → Boolean, YYYY-MM-DD → LocalDate, дата-время → LocalDateTime, прочие строки (включая строки из одних цифр) → String.Map<String, Object>, а массивы — List<...>, оба с аннотацией @JdbcTypeCode(SqlTypes.JSON), чтобы Hibernate 6 хранил их в JSON-колонке.@Column(name = "guest_name") сохраняет исходный ключ как имя колонки, если имя поля Java отличается; ключи — ключевые слова Java, вроде class, становятся class_.id или целочисленный id дают @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, строковый id — простой @Id private String id.@NotEmpty(), если это непустые строки, и @NotNull() в остальных случаях, так как @NotEmpty применим только к строкам и коллекциям.@FieldNameConstants из Lombok генерирует константы имён вроде Reservation.Fields.guestName.Когда бронирования или заказы из другой системы нужно периодически забирать и сохранять, один JSON ответа даёт сущность, а каркас batch-задачи вокруг saveAll() дописывается быстро.
Если локально включено spring.jpa.hibernate.ddl-auto=update, Hibernate создаст таблицу по сгенерированной сущности, и данные для работы над UI можно загрузить сразу.
jakarta. обратно на javax. и замените @JdbcTypeCode конвертером, так как в Hibernate 5 его нет.149.0 в JSON разбирается в то же число, что и 149, поэтому становится Long. Чтобы поле вышло Double, в примере нужно дробное значение, а для денег лучше подходит BigDecimal.2024-08-09T15:00:00+09:00, теряют смещение в LocalDateTime. Если важен момент времени, используйте OffsetDateTime или Instant.Map на класс @Embedded или связь @OneToMany.@Column(name = ...) на поля, которые Spring и так отобразит в snake_case?Стратегия именования Spring Boot по умолчанию действительно превращает guestName в guest_name, но это ломается, как только ключ оказывается не обычным snake_case или стратегию меняют. Явное имя сохраняет маппинг правильным при любой конфигурации.
@NotNull при сохранении?Если на classpath есть spring-boot-starter-validation (Hibernate Validator), Hibernate запускает Bean Validation прямо перед persist и update и выбрасывает ConstraintViolationException. Без него аннотации игнорируются.
@FieldNameConstants?Lombok генерирует строковые константы вроде Reservation.Fields.checkIn. Используйте их в Sort.by(Reservation.Fields.checkIn) или в запросах Specification/Criteria вместо строковых литералов — тогда переименование поля сломает сборку, а не запрос.