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 ক্লাসে কনভার্ট করে। একটিমাত্র Java ফাইলে থাকে jakarta.persistence আর jakarta.validation import, একটি @Id primary key, প্রতিটি key-এর জন্য একটি private ফিল্ড, Lombok-এর @Getter, @Setter ও @FieldNameConstants, আর Bean Validation-এর @NotEmpty/@NotNull।

ইন্টিগ্রেশন পার্টনারের নমুনা JSON বা স্ক্রিন স্পেক থেকে শুরু করে দ্রুত টেবিলে ম্যাপ করা entity দরকার, এমন Spring Boot ব্যাকএন্ডের কাজের জন্য এটি তৈরি।

কীভাবে ব্যবহার করবেন

  1. একটি রেকর্ড অবজেক্ট হিসেবে বা কয়েকটি array হিসেবে পেস্ট করুন। কোনো রেকর্ডে না থাকা ফিল্ড কোনো validation annotation পায় না।
  2. মডেলের নাম-এ entity ক্লাসের নাম দিন (ডিফল্ট MyModel)। এর ছোট হাতের রূপ package-এর শেষেও ব্যবহৃত হয় (com.hello.world.reservation)।
  3. package লাইনটি আপনার প্রজেক্টের 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-এর মতো integer হয়েছে Long, rate হয়েছে Double, আর check_in হয়েছে LocalDateTime। প্রতিটি snake_case key @Column(name = "...") পায়, আর প্রতিটি ভ্যালু পূরণ করা থাকায় String ফিল্ড guestName পায় @NotEmpty() আর বাকিগুলো @NotNull()।

সমর্থিত বৈশিষ্ট্য

  • Java type: integer → Long, দশমিক → Double, boolean → Boolean, YYYY-MM-DD → LocalDate, date-time → LocalDateTime, অন্যান্য স্ট্রিং (শুধু সংখ্যার স্ট্রিংসহ) → String।
  • অবজেক্ট হয় Map<String, Object> আর array হয় List<...>, দুটোতেই @JdbcTypeCode(SqlTypes.JSON) থাকে, যাতে Hibernate 6 সেগুলো JSON কলামে রাখে।
  • Java ফিল্ডের নাম আলাদা হলে @Column(name = "guest_name") মূল key-কে কলামের নাম হিসেবে রাখে; class-এর মতো Java keyword key হয় class_।
  • Primary key আপনার JSON অনুসরণ করে: id না থাকলে বা integer id হলে @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, স্ট্রিং id হলে সাধারণ @Id private String id।
  • সবসময় থাকা ফিল্ড ফাঁকা নয় এমন স্ট্রিং হলে @NotEmpty() আর অন্যথায় @NotNull() পায়, কারণ @NotEmpty শুধু স্ট্রিং আর collection-এ প্রযোজ্য।
  • Lombok @FieldNameConstants Reservation.Fields.guestName-এর মতো নামের কনস্ট্যান্ট তৈরি করে।

ব্যবহারের ক্ষেত্র

এক্সটার্নাল API ডেটা সংরক্ষণ করা batch job

অন্য সিস্টেম থেকে রিজার্ভেশন বা অর্ডার নিয়মিত টেনে এনে সেভ করতে হলে একটি response JSON থেকেই entity পাওয়া যায়, আর saveAll() ঘিরে batch job-এর কাঠামো দ্রুত দাঁড়িয়ে যায়।

`ddl-auto` দিয়ে ডেভেলপমেন্ট টেবিল

লোকালে spring.jpa.hibernate.ddl-auto=update চালু থাকলে Hibernate জেনারেট হওয়া entity থেকে টেবিল তৈরি করে, তাই UI-এর কাজের জন্য সাথে সাথেই ডেটা লোড করতে পারেন।

নোট ও সীমাবদ্ধতা

  • Import-গুলো Jakarta EE (Spring Boot 3, Hibernate 6) লক্ষ্য করে। Spring Boot 2-এ jakarta.-কে আবার javax.-এ বদলান এবং @JdbcTypeCode-কে একটি converter দিয়ে বদলান, কারণ Hibernate 5-এ এটি নেই।
  • JSON-এ 149.0 parse হয়ে 149-এর সমান সংখ্যা হয়, তাই এটি Long হয়। দশমিক ফিল্ড Double হিসেবে পেতে নমুনায় ভগ্নাংশসহ ভ্যালু লাগবে, আর টাকার জন্য BigDecimal বেশি উপযুক্ত।
  • 2024-08-09T15:00:00+09:00-এর মতো offset-সহ timestamp LocalDateTime-এ offset হারায়। সঠিক মুহূর্তটি গুরুত্বপূর্ণ হলে OffsetDateTime বা Instant ব্যবহার করুন।
  • JSON কলামের জন্য এমন ডাটাবেস লাগে যেখানে এটি আছে (MySQL 5.7+, PostgreSQL, H2 2.x)। আসল relation-এর জন্য Map-কে একটি @Embedded ক্লাস বা @OneToMany association দিয়ে বদলান।

সাধারণ প্রশ্ন

Spring যেসব ফিল্ড এমনিতেই snake_case-এ ম্যাপ করত, সেগুলোতে কেন @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 ভাঙবে।