Преобразуйте JSON в схему Spring Boot JPA!

Введите JSON и преобразуйте его в схему Spring Boot JPA! Поддержка: Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok.
JSON
Результат
 

Преобразуйте JSON в схему Spring Boot JPA!

Преобразует 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 от партнёра по интеграции или из спецификации экрана.

Как пользоваться

  1. Вставьте одну запись как объект или несколько как массив. Поля, отсутствующие хотя бы в одной записи, не получают аннотаций валидации.
  2. Введите имя класса сущности в Имя модели (по умолчанию MyModel). Его форма в нижнем регистре также используется в конце пакета (com.hello.world.reservation).
  3. Замените строку package на пакет своего проекта, сохраните как Reservation.java и создайте репозиторий, наследующий JpaRepository<Reservation, Long>.

Пример

Вход (JSON)
{
  "guest_name": "Hana Lee",
  "room_no": 1204,
  "nights": 3,
  "rate": 149.5,
  "breakfast": true,
  "check_in": "2024-08-09T15:00:00"
}
Результат (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;
}

Целые вроде room_no и nights стали Long, rate — Double, а check_in — LocalDateTime. Каждый ключ в snake_case получает @Column(name = "..."), и поскольку все значения заполнены, поле String guestName получает @NotEmpty(), а остальные — @NotNull().

Возможности

  • Типы Java: целые → 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_.
  • Первичный ключ следует вашему JSON: отсутствие id или целочисленный id дают @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, строковый id — простой @Id private String id.
  • Всегда присутствующие поля получают @NotEmpty(), если это непустые строки, и @NotNull() в остальных случаях, так как @NotEmpty применим только к строкам и коллекциям.
  • @FieldNameConstants из Lombok генерирует константы имён вроде Reservation.Fields.guestName.

Сценарии использования

Batch-задачи, сохраняющие данные внешних API

Когда бронирования или заказы из другой системы нужно периодически забирать и сохранять, один JSON ответа даёт сущность, а каркас batch-задачи вокруг saveAll() дописывается быстро.

Таблицы для разработки через `ddl-auto`

Если локально включено spring.jpa.hibernate.ddl-auto=update, Hibernate создаст таблицу по сгенерированной сущности, и данные для работы над UI можно загрузить сразу.

Примечания и ограничения

  • Импорты рассчитаны на Jakarta EE (Spring Boot 3, Hibernate 6). На Spring Boot 2 верните jakarta. обратно на javax. и замените @JdbcTypeCode конвертером, так как в Hibernate 5 его нет.
  • 149.0 в JSON разбирается в то же число, что и 149, поэтому становится Long. Чтобы поле вышло Double, в примере нужно дробное значение, а для денег лучше подходит BigDecimal.
  • Метки времени со смещением, вроде 2024-08-09T15:00:00+09:00, теряют смещение в LocalDateTime. Если важен момент времени, используйте OffsetDateTime или Instant.
  • JSON-колонкам нужна база, где они есть (MySQL 5.7+, PostgreSQL, H2 2.x). Для настоящих связей замените 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 вместо строковых литералов — тогда переименование поля сломает сборку, а не запрос.