JSON-কে Spring Boot 3-এর Spring Data JPA-র জন্য একটি @Entity ক্লাসে কনভার্ট করে। একটিমাত্র Java ফাইলে থাকে jakarta.persistence আর jakarta.validation import, একটি @Id primary key, প্রতিটি key-এর জন্য একটি private ফিল্ড, Lombok-এর @Getter, @Setter ও @FieldNameConstants, আর Bean Validation-এর @NotEmpty/@NotNull।
ইন্টিগ্রেশন পার্টনারের নমুনা JSON বা স্ক্রিন স্পেক থেকে শুরু করে দ্রুত টেবিলে ম্যাপ করা entity দরকার, এমন Spring Boot ব্যাকএন্ডের কাজের জন্য এটি তৈরি।
মডেলের নাম-এ entity ক্লাসের নাম দিন (ডিফল্ট MyModel)। এর ছোট হাতের রূপ package-এর শেষেও ব্যবহৃত হয় (com.hello.world.reservation)।package লাইনটি আপনার প্রজেক্টের 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-এর মতো integer হয়েছে Long, rate হয়েছে Double, আর check_in হয়েছে LocalDateTime। প্রতিটি snake_case key @Column(name = "...") পায়, আর প্রতিটি ভ্যালু পূরণ করা থাকায় String ফিল্ড guestName পায় @NotEmpty() আর বাকিগুলো @NotNull()।
Long, দশমিক → Double, boolean → Boolean, YYYY-MM-DD → LocalDate, date-time → LocalDateTime, অন্যান্য স্ট্রিং (শুধু সংখ্যার স্ট্রিংসহ) → String।Map<String, Object> আর array হয় List<...>, দুটোতেই @JdbcTypeCode(SqlTypes.JSON) থাকে, যাতে Hibernate 6 সেগুলো JSON কলামে রাখে।@Column(name = "guest_name") মূল key-কে কলামের নাম হিসেবে রাখে; class-এর মতো Java keyword key হয় class_।id না থাকলে বা integer id হলে @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, স্ট্রিং id হলে সাধারণ @Id private String id।@NotEmpty() আর অন্যথায় @NotNull() পায়, কারণ @NotEmpty শুধু স্ট্রিং আর collection-এ প্রযোজ্য।@FieldNameConstants Reservation.Fields.guestName-এর মতো নামের কনস্ট্যান্ট তৈরি করে।অন্য সিস্টেম থেকে রিজার্ভেশন বা অর্ডার নিয়মিত টেনে এনে সেভ করতে হলে একটি response JSON থেকেই entity পাওয়া যায়, আর saveAll() ঘিরে batch job-এর কাঠামো দ্রুত দাঁড়িয়ে যায়।
লোকালে spring.jpa.hibernate.ddl-auto=update চালু থাকলে Hibernate জেনারেট হওয়া entity থেকে টেবিল তৈরি করে, তাই UI-এর কাজের জন্য সাথে সাথেই ডেটা লোড করতে পারেন।
jakarta.-কে আবার javax.-এ বদলান এবং @JdbcTypeCode-কে একটি converter দিয়ে বদলান, কারণ Hibernate 5-এ এটি নেই।149.0 parse হয়ে 149-এর সমান সংখ্যা হয়, তাই এটি Long হয়। দশমিক ফিল্ড Double হিসেবে পেতে নমুনায় ভগ্নাংশসহ ভ্যালু লাগবে, আর টাকার জন্য BigDecimal বেশি উপযুক্ত।2024-08-09T15:00:00+09:00-এর মতো offset-সহ timestamp LocalDateTime-এ offset হারায়। সঠিক মুহূর্তটি গুরুত্বপূর্ণ হলে OffsetDateTime বা Instant ব্যবহার করুন।Map-কে একটি @Embedded ক্লাস বা @OneToMany association দিয়ে বদলান।@Column(name = ...)?Spring Boot-এর ডিফল্ট naming strategy ঘটনাচক্রে guestName-কে guest_name-এ বদলায়, কিন্তু কোনো key সাধারণ snake_case না হলে বা strategy বদলানো হলেই তা ভেঙে যায়। স্পষ্ট নাম থাকলে কনফিগারেশন যা-ই হোক ম্যাপিং সঠিক থাকে।
@NotNull প্রয়োগ হয়?Classpath-এ spring-boot-starter-validation (Hibernate Validator) থাকলে Hibernate persist আর update-এর ঠিক আগে Bean Validation চালায় এবং ConstraintViolationException ছোড়ে। না থাকলে annotation-গুলো উপেক্ষিত হয়।
@FieldNameConstants কীসের জন্য?Lombok Reservation.Fields.checkIn-এর মতো স্ট্রিং কনস্ট্যান্ট তৈরি করে। String literal-এর বদলে এগুলো Sort.by(Reservation.Fields.checkIn) বা Specification/Criteria কোয়েরিতে ব্যবহার করুন, তাহলে ফিল্ডের নাম বদলালে কোয়েরি নয়, build ভাঙবে।