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 चाहिए।
मॉडल का नाम में entity class का नाम डालें (default MyModel)। इसका lowercase रूप package के अंत में भी इस्तेमाल होता है (com.hello.world.reservation)।package line को अपने project के package में बदलें, इसे Reservation.java के रूप में सेव करें, और JpaRepository<Reservation, Long> को extend करने वाली repository बनाएं।{
"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 जैसे integers Long बने, rate Double, और check_in LocalDateTime। हर snake_case key को @Column(name = "...") मिलता है, और क्योंकि हर वैल्यू भरी है, String field guestName को @NotEmpty() और बाकी को @NotNull() मिलता है।
Long, decimals → Double, booleans → Boolean, YYYY-MM-DD → LocalDate, date-times → LocalDateTime, बाकी strings (सिर्फ़ अंकों वाली समेत) → String।Map<String, Object> और arrays List<...> बनते हैं, दोनों पर @JdbcTypeCode(SqlTypes.JSON) लगता है ताकि Hibernate 6 उन्हें JSON column में store करे।@Column(name = "guest_name") मूल key को column नाम के रूप में रखता है; class जैसे Java keywords वाली keys class_ बनती हैं।id न हो या integer id हो तो @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, string id हो तो सादा @Id private String id।@NotEmpty() और वरना @NotNull() मिलता है, क्योंकि @NotEmpty सिर्फ़ strings और collections पर लागू होता है।@FieldNameConstants Reservation.Fields.guestName जैसे नाम constants बनाता है।जब दूसरे system से reservations या orders समय-समय पर खींचकर सेव करने हों, तो एक response JSON से entity मिल जाती है, और saveAll() के आसपास batch job का ढांचा जल्दी बन जाता है।
Local में spring.jpa.hibernate.ddl-auto=update चालू होने पर Hibernate बनी हुई entity से table बनाता है, इसलिए UI काम के लिए तुरंत data load कर सकते हैं।
jakarta. को वापस javax. में बदलें और @JdbcTypeCode को converter से बदलें, क्योंकि यह Hibernate 5 में नहीं है।149.0 149 जैसी ही संख्या के रूप में parse होता है, इसलिए वह Long बनता है। Decimal field को Double के रूप में निकालने के लिए sample में भिन्नात्मक वैल्यू चाहिए, और पैसे के लिए BigDecimal बेहतर है।2024-08-09T15:00:00+09:00 जैसे offset वाले timestamps LocalDateTime में offset खो देते हैं। जब सटीक क्षण मायने रखे तो OffsetDateTime या Instant इस्तेमाल करें।Map को @Embedded class या @OneToMany association से बदलें।@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 टूटे।