JSON को Spring Boot JPA स्कीमा में बदलें!

JSON दर्ज करें और इसे Spring Boot JPA स्कीमा में बदलें! Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok समर्थित।
JSON
परिणाम
 

JSON को Spring Boot JPA स्कीमा में बदलें!

JSON को Spring Boot 3 पर Spring Data JPA के लिए @Entity class में बदलता है। एक ही Java फ़ाइल में jakarta.persistence और jakarta.validation imports, @Id primary key, हर key के लिए private field, Lombok के @Getter, @Setter और @FieldNameConstants, और Bean Validation के @NotEmpty/@NotNull होते हैं।

यह Spring Boot backend काम के लिए है, जहां integration partner के sample JSON या screen spec से शुरू करके जल्दी से table से map होने वाली entity चाहिए।

उपयोग कैसे करें

  1. एक record object के रूप में या कई array के रूप में पेस्ट करें। किसी भी record में न मौजूद fields को validation annotation नहीं मिलता।
  2. मॉडल का नाम में entity class का नाम डालें (default MyModel)। इसका lowercase रूप package के अंत में भी इस्तेमाल होता है (com.hello.world.reservation)।
  3. package line को अपने project के package में बदलें, इसे Reservation.java के रूप में सेव करें, और JpaRepository<Reservation, Long> को extend करने वाली repository बनाएं।

उदाहरण

इनपुट (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 जैसे integers Long बने, rate Double, और check_in LocalDateTime। हर snake_case key को @Column(name = "...") मिलता है, और क्योंकि हर वैल्यू भरी है, String field guestName को @NotEmpty() और बाकी को @NotNull() मिलता है।

समर्थित सुविधाएँ

  • Java types: integers → Long, decimals → Double, booleans → Boolean, YYYY-MM-DD → LocalDate, date-times → LocalDateTime, बाकी strings (सिर्फ़ अंकों वाली समेत) → String।
  • Objects Map<String, Object> और arrays List<...> बनते हैं, दोनों पर @JdbcTypeCode(SqlTypes.JSON) लगता है ताकि Hibernate 6 उन्हें JSON column में store करे।
  • जब भी Java field नाम अलग हो, @Column(name = "guest_name") मूल key को column नाम के रूप में रखता है; class जैसे Java keywords वाली keys class_ बनती हैं।
  • Primary key आपके JSON का पालन करती है: id न हो या integer id हो तो @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, string id हो तो सादा @Id private String id।
  • हमेशा मौजूद fields को खाली न होने वाली strings होने पर @NotEmpty() और वरना @NotNull() मिलता है, क्योंकि @NotEmpty सिर्फ़ strings और collections पर लागू होता है।
  • Lombok @FieldNameConstants Reservation.Fields.guestName जैसे नाम constants बनाता है।

उपयोग के मामले

बाहरी API data store करने वाले batch jobs

जब दूसरे system से reservations या orders समय-समय पर खींचकर सेव करने हों, तो एक response JSON से entity मिल जाती है, और saveAll() के आसपास batch job का ढांचा जल्दी बन जाता है।

`ddl-auto` से development tables

Local में spring.jpa.hibernate.ddl-auto=update चालू होने पर Hibernate बनी हुई entity से table बनाता है, इसलिए UI काम के लिए तुरंत data load कर सकते हैं।

नोट्स और सीमाएँ

  • Imports Jakarta EE (Spring Boot 3, Hibernate 6) को target करते हैं। Spring Boot 2 पर jakarta. को वापस javax. में बदलें और @JdbcTypeCode को converter से बदलें, क्योंकि यह Hibernate 5 में नहीं है।
  • JSON में 149.0 149 जैसी ही संख्या के रूप में parse होता है, इसलिए वह Long बनता है। Decimal field को Double के रूप में निकालने के लिए sample में भिन्नात्मक वैल्यू चाहिए, और पैसे के लिए BigDecimal बेहतर है।
  • 2024-08-09T15:00:00+09:00 जैसे offset वाले timestamps LocalDateTime में offset खो देते हैं। जब सटीक क्षण मायने रखे तो OffsetDateTime या Instant इस्तेमाल करें।
  • JSON columns के लिए ऐसा database चाहिए जिसमें वे हों (MySQL 5.7+, PostgreSQL, H2 2.x)। असली relations के लिए Map को @Embedded class या @OneToMany association से बदलें।

अक्सर पूछे जाने वाले प्रश्न

जिन fields को Spring वैसे भी snake_case से map करता, उन पर @Column(name = ...) क्यों?

Spring Boot की default naming strategy संयोग से guestName को guest_name बना देती है, लेकिन जैसे ही कोई key सादा snake_case न हो या strategy बदल दी जाए, यह टूट जाता है। Explicit नाम configuration चाहे जो हो, mapping सही रखता है।

क्या सेव करते समय @NotNull लागू होता है?

Classpath पर spring-boot-starter-validation (Hibernate Validator) होने पर Hibernate persist और update से ठीक पहले Bean Validation चलाता है और ConstraintViolationException देता है। इसके बिना annotations अनदेखे होते हैं।

@FieldNameConstants किसलिए है?

Lombok Reservation.Fields.checkIn जैसे string constants बनाता है। String literals की बजाय इन्हें Sort.by(Reservation.Fields.checkIn) या Specification/Criteria queries में इस्तेमाल करें, ताकि field rename करने पर query की बजाय build टूटे।