Konvertieren Sie JSON in Spring Boot JPA-Schema!

Geben Sie JSON ein und konvertieren Sie es in ein Spring Boot JPA-Schema! Unterstützt Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok.
JSON
Ergebnis
 

Konvertieren Sie JSON in Spring Boot JPA-Schema!

Wandelt JSON in eine @Entity-Klasse für Spring Data JPA unter Spring Boot 3 um. Die einzelne Java-Datei enthält Imports aus jakarta.persistence und jakarta.validation, einen @Id-Primärschlüssel, ein private-Feld pro Key, @Getter, @Setter und @FieldNameConstants von Lombok sowie @NotEmpty/@NotNull aus Bean Validation.

Gedacht ist das für die Backend-Arbeit mit Spring Boot, wenn du schnell eine auf eine Tabelle abgebildete Entity brauchst, ausgehend von Beispiel-JSON eines Integrationspartners oder einer Screen-Spezifikation.

So funktioniert es

  1. Füge einen Datensatz als Objekt oder mehrere als Array ein. Felder, die in irgendeinem Datensatz fehlen, bekommen keine Validierungsannotation.
  2. Gib den Namen der Entity-Klasse in Modellname ein (Standard MyModel). Seine kleingeschriebene Form wird auch am Ende des Packages verwendet (com.hello.world.reservation).
  3. Ändere die package-Zeile auf das Package deines Projekts, speichere die Datei als Reservation.java und lege ein Repository an, das JpaRepository<Reservation, Long> erweitert.

Beispiel

Eingabe (JSON)
{
  "guest_name": "Hana Lee",
  "room_no": 1204,
  "nights": 3,
  "rate": 149.5,
  "breakfast": true,
  "check_in": "2024-08-09T15:00:00"
}
Ausgabe (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;
}

Ganzzahlen wie room_no und nights wurden zu Long, rate zu Double und check_in zu LocalDateTime. Jeder snake_case-Key bekommt @Column(name = "..."), und da jeder Wert befüllt ist, erhält das String-Feld guestName ein @NotEmpty() und die übrigen ein @NotNull().

Unterstützte Funktionen

  • Java-Typen: Ganzzahlen → Long, Dezimalzahlen → Double, Booleans → Boolean, YYYY-MM-DD → LocalDate, Datum mit Uhrzeit → LocalDateTime, andere Strings (auch reine Ziffern-Strings) → String.
  • Objekte werden zu Map<String, Object> und Arrays zu List<...>, beide mit @JdbcTypeCode(SqlTypes.JSON) annotiert, damit Hibernate 6 sie in einer JSON-Spalte speichert.
  • @Column(name = "guest_name") behält den ursprünglichen Key als Spaltennamen, wann immer der Java-Feldname abweicht; Keys, die Java-Schlüsselwörter sind, wie class, werden zu class_.
  • Der Primärschlüssel richtet sich nach deinem JSON: kein id oder eine ganzzahlige id ergibt @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, eine String-id ergibt ein einfaches @Id private String id.
  • Immer vorhandene Felder bekommen @NotEmpty(), wenn sie nicht leere Strings sind, sonst @NotNull(), da @NotEmpty nur für Strings und Collections gilt.
  • @FieldNameConstants von Lombok erzeugt Namenskonstanten wie Reservation.Fields.guestName.

Anwendungsfälle

Batch-Jobs, die Daten externer APIs speichern

Müssen Reservierungen oder Bestellungen aus einem anderen System regelmäßig abgeholt und gespeichert werden, liefert dir ein einziges Antwort-JSON die Entity, und das Gerüst des Batch-Jobs rund um saveAll() steht schnell.

Entwicklungstabellen über `ddl-auto`

Ist lokal spring.jpa.hibernate.ddl-auto=update aktiviert, legt Hibernate die Tabelle aus der erzeugten Entity an, und du kannst sofort Daten für die UI-Arbeit laden.

Hinweise und Einschränkungen

  • Die Imports zielen auf Jakarta EE (Spring Boot 3, Hibernate 6). Unter Spring Boot 2 änderst du jakarta. zurück in javax. und ersetzt @JdbcTypeCode durch einen Converter, da es in Hibernate 5 nicht existiert.
  • 149.0 im JSON wird zur selben Zahl geparst wie 149 und daher zu Long. Ein Dezimalfeld braucht im Beispiel einen Wert mit Nachkommastellen, um als Double herauszukommen, und für Geldbeträge ist BigDecimal besser geeignet.
  • Zeitstempel mit Offset wie 2024-08-09T15:00:00+09:00 verlieren in LocalDateTime ihren Offset. Verwende OffsetDateTime oder Instant, wenn der genaue Zeitpunkt zählt.
  • JSON-Spalten brauchen eine Datenbank, die sie unterstützt (MySQL 5.7+, PostgreSQL, H2 2.x). Für echte Beziehungen ersetze die Map durch eine @Embedded-Klasse oder eine @OneToMany-Assoziation.

Häufige Fragen

Warum @Column(name = ...) an Feldern, die Spring ohnehin auf snake_case abbilden würde?

Die Standard-Naming-Strategie von Spring Boot macht zwar aus guestName ein guest_name, das bricht aber, sobald ein Key kein reines snake_case ist oder die Strategie geändert wird. Der explizite Name hält die Zuordnung unabhängig von der Konfiguration korrekt.

Wird @NotNull beim Speichern durchgesetzt?

Liegt spring-boot-starter-validation (Hibernate Validator) im Classpath, führt Hibernate Bean Validation direkt vor Persist und Update aus und wirft ConstraintViolationException. Ohne ihn werden die Annotationen ignoriert.

Wofür ist @FieldNameConstants da?

Lombok erzeugt String-Konstanten wie Reservation.Fields.checkIn. Verwende sie in Sort.by(Reservation.Fields.checkIn) oder in Specification/Criteria-Abfragen statt String-Literalen, damit das Umbenennen eines Feldes den Build bricht statt der Abfrage.