Konversi JSON ke Skema Spring Boot JPA!

Masukkan JSON dan konversikan ke skema Spring Boot JPA! Mendukung Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok.
JSON
Hasil
 

Konversi JSON ke Skema Spring Boot JPA!

Mengonversi JSON menjadi class @Entity untuk Spring Data JPA di Spring Boot 3. Satu file Java ini berisi import jakarta.persistence dan jakarta.validation, primary key @Id, field private untuk setiap key, @Getter, @Setter dan @FieldNameConstants dari Lombok, serta @NotEmpty/@NotNull dari Bean Validation.

Ditujukan untuk pekerjaan backend Spring Boot ketika Anda butuh entity yang dipetakan ke tabel dengan cepat, berangkat dari contoh JSON dari partner integrasi atau spesifikasi layar.

Cara menggunakan

  1. Tempel satu record sebagai objek atau beberapa sebagai array. Field yang tidak ada di salah satu record tidak mendapat anotasi validasi.
  2. Isi nama class entity di Nama model (default MyModel). Bentuk huruf kecilnya juga dipakai di akhir package (com.hello.world.reservation).
  3. Ubah baris package ke package proyek Anda, simpan sebagai Reservation.java, lalu buat repository yang meng-extend JpaRepository<Reservation, Long>.

Contoh

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

Integer seperti room_no dan nights menjadi Long, rate menjadi Double, dan check_in menjadi LocalDateTime. Setiap key snake_case mendapat @Column(name = "..."), dan karena semua nilai terisi, field String guestName mendapat @NotEmpty() dan yang lainnya @NotNull().

Fitur yang didukung

  • Tipe Java: integer → Long, desimal → Double, boolean → Boolean, YYYY-MM-DD → LocalDate, tanggal-waktu → LocalDateTime, string lainnya (termasuk yang hanya berisi angka) → String.
  • Objek menjadi Map<String, Object> dan array menjadi List<...>, keduanya diberi anotasi @JdbcTypeCode(SqlTypes.JSON) agar Hibernate 6 menyimpannya di kolom JSON.
  • @Column(name = "guest_name") mempertahankan key asli sebagai nama kolom setiap kali nama field Java berbeda; key yang merupakan keyword Java, seperti class, menjadi class_.
  • Primary key mengikuti JSON Anda: tanpa id atau id integer menghasilkan @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, id string menghasilkan @Id private String id biasa.
  • Field yang selalu ada mendapat @NotEmpty() jika berupa string tidak kosong dan @NotNull() untuk lainnya, karena @NotEmpty hanya berlaku untuk string dan collection.
  • @FieldNameConstants dari Lombok membuat konstanta nama seperti Reservation.Fields.guestName.

Kasus penggunaan

Batch job yang menyimpan data API eksternal

Ketika reservasi atau pesanan dari sistem lain harus ditarik secara berkala dan disimpan, satu JSON respons memberi Anda entity-nya, dan kerangka batch job di sekitar saveAll() bisa menyusul dengan cepat.

Tabel development lewat `ddl-auto`

Dengan spring.jpa.hibernate.ddl-auto=update aktif di lokal, Hibernate membuat tabel dari entity yang dihasilkan, sehingga Anda bisa langsung memuat data untuk pekerjaan UI.

Catatan dan batasan

  • Import menargetkan Jakarta EE (Spring Boot 3, Hibernate 6). Di Spring Boot 2, ubah kembali jakarta. menjadi javax. dan ganti @JdbcTypeCode dengan converter, karena anotasi itu tidak ada di Hibernate 5.
  • 149.0 di JSON di-parse menjadi angka yang sama dengan 149, jadi menjadi Long. Field desimal butuh nilai pecahan di contoh agar keluar sebagai Double, dan untuk uang lebih baik memakai BigDecimal.
  • Timestamp dengan offset, seperti 2024-08-09T15:00:00+09:00, kehilangan offset-nya di LocalDateTime. Gunakan OffsetDateTime atau Instant ketika titik waktunya penting.
  • Kolom JSON memerlukan database yang mendukungnya (MySQL 5.7+, PostgreSQL, H2 2.x). Untuk relasi sungguhan, ganti Map dengan class @Embedded atau asosiasi @OneToMany.

FAQ

Mengapa memasang @Column(name = ...) pada field yang toh akan dipetakan Spring ke snake_case?

Naming strategy default Spring Boot kebetulan mengubah guestName menjadi guest_name, tetapi itu rusak begitu ada key yang bukan snake_case biasa atau strateginya diubah. Nama yang eksplisit menjaga pemetaan tetap benar apa pun konfigurasinya.

Apakah @NotNull ditegakkan saat menyimpan?

Dengan spring-boot-starter-validation (Hibernate Validator) di classpath, Hibernate menjalankan Bean Validation tepat sebelum persist dan update lalu melempar ConstraintViolationException. Tanpa itu, anotasinya diabaikan.

Untuk apa @FieldNameConstants?

Lombok membuat konstanta string seperti Reservation.Fields.checkIn. Gunakan di Sort.by(Reservation.Fields.checkIn) atau di query Specification/Criteria alih-alih string literal, sehingga mengganti nama field merusak build, bukan query-nya.