JSON কে Spring Boot MongoDB সমাধানে রূপান্তর করুন!

JSON ইনপুট করুন এবং এটিকে Spring Boot MongoDB সমাধানে রূপান্তর করুন! Spring Data MongoDB, @Document, @Id সমর্থিত।
JSON
ফলাফল
 

JSON কে Spring Boot MongoDB সমাধানে রূপান্তর করুন!

JSON ডকুমেন্টকে Spring Data MongoDB-র একটি @Document ক্লাসে কনভার্ট করে: @Document-এ নাম দেওয়া কালেকশন, একটি @Id ফিল্ড, প্রতিটি key-এর জন্য একটি private ফিল্ড (সংরক্ষিত key আলাদা হলে @Field-সহ), সাথে Lombok আর jakarta.validation annotation, সবই একটি Java ফাইলে।

সাধারণ JSON হিসেবে MongoDB-তে জমা হওয়া ডেটা (IoT রিডিং, ইভেন্ট, scraping-এর ফলাফল) যখন Spring Boot সার্ভিস থেকে একটি MongoRepository-র মাধ্যমে পড়া ও লেখা দরকার, তখন এটি ব্যবহার করুন।

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

  1. কালেকশনে যেসব ডকুমেন্ট আছে বা থাকবে সেগুলো পেস্ট করুন। mongosh-এ find().limit(5)-এর আউটপুটের মতো কয়েকটি array হিসেবে পেস্ট করলে মাঝে মাঝে আসা ফিল্ড আর স্থায়ী ফিল্ড আলাদা হয়ে যায়।
  2. একটি মডেলের নাম লিখুন (ফাঁকা রাখলে MyModel); এটি ক্লাসের নাম আর @Document(collection = "...")-এর কালেকশন দুই জায়গাতেই ব্যবহৃত হয়।
  3. package লাইন ঠিক করে ফাইলটি সেভ করুন, তারপর MongoRepository<DeviceLog, String> extend করা একটি repository তৈরি করুন।

উদাহরণ

ইনপুট (JSON)
[
  { "device_id": "th-sensor-07", "temperature": 21.4, "battery": 87, "online": true, "recorded_at": "2024-02-11T06:00:00Z" },
  { "device_id": "th-sensor-09", "temperature": 19.8, "battery": 12, "online": false, "recorded_at": "2024-02-11T06:00:00Z", "firmware": "1.4.2" }
]
আউটপুট (Spring Data MongoDB)
package com.hello.world.devicelog;

import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
import org.springframework.data.mongodb.core.mapping.Field;

import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.NotNull;

import java.time.LocalDateTime;

import lombok.Getter;
import lombok.Setter;
import lombok.experimental.FieldNameConstants;

@Document(collection = "DeviceLog")
@FieldNameConstants
@Getter
@Setter
public class DeviceLog {
    @Id
    private String id;

    @NotEmpty()
    @Field("device_id")
    private String deviceId;

    @NotNull()
    private Double temperature;

    @NotNull()
    private Long battery;

    @NotNull()
    private Boolean online;

    @NotNull()
    @Field("recorded_at")
    private LocalDateTime recordedAt;

    private String firmware;
}

firmware শুধু দ্বিতীয় ডকুমেন্টে আছে, তাই এতে কোনো annotation নেই। device_id আর recorded_at পড়া হয় @Field("device_id") আর @Field("recorded_at") দিয়ে, তাই বিদ্যমান ডকুমেন্টগুলো migration ছাড়াই camelCase ফিল্ডে ম্যাপ হয়।

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

  • @Document(collection = "DeviceLog") দিয়ে কালেকশনের নাম স্পষ্টভাবে দেয়।
  • @Id private String id MongoDB-র _id ধারণ করে; আপনার JSON-এর id বা _id key আলাদা করে না রেখে এতে মিশিয়ে দেওয়া হয়, আর সংখ্যার id হলে এটি Long হয়।
  • প্রতিটি ফিল্ডের type তার ভ্যালু থেকে ঠিক হয়: Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (date-time) বা String; embedded অবজেক্ট হয় Map<String, Object> আর array হয় List<...>।
  • Java নাম সংরক্ষিত key না হলেই @Field("...") যোগ হয়, শেষে _ দিয়ে নাম বদলানো Java keyword-সহ।
  • প্রতিটি ডকুমেন্টে থাকা ফিল্ড ফাঁকা নয় এমন স্ট্রিং হলে @NotEmpty() আর অন্যথায় @NotNull() পায়; মাঝে মাঝে আসা বা null ফিল্ড কিছুই পায় না।

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

সেন্সর বা লগ কালেকশনের উপর কোয়েরি API

ডিভাইস সরাসরি MongoDB-তে যে রিডিং লেখে তা ড্যাশবোর্ডে দেখাতে হলে কয়েকটি ডকুমেন্ট পেস্ট করে ক্লাস পান এবং সাথে সাথেই findByDeviceIdOrderByRecordedAtDesc-এর মতো derived query ডিক্লেয়ার করুন।

Node.js সার্ভিসের সাথে একটি কালেকশন শেয়ার করা

অন্য কোনো সার্ভিস আগে থেকেই snake_case-এ লেখে এমন কালেকশন Spring-কে পড়তে হলে, @Field annotation-এর কারণে Java-র দিকে camelCase নাম ব্যবহার করেও একই key পড়া ও লেখা যায়।

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

  • ডিফল্টভাবে সেভ করার সময় @NotEmpty আর @NotNull চেক হয় না; save()-এর ঠিক আগে validate করতে একটি ValidatingMongoEventListener bean রেজিস্টার করুন।
  • LocalDateTime MongoDB-তে UTC-ভিত্তিক Date হিসেবে সংরক্ষিত হয় এবং সার্ভারের time zone অনুযায়ী সরে যেতে পারে। যেসব লগে সঠিক মুহূর্ত গুরুত্বপূর্ণ সেখানে Instant বেশি নিরাপদ।
  • Long id MongoDB তৈরি করে না; সেভ করার আগে আপনাকেই সেট করতে হবে। শুধু String, ObjectId আর BigInteger id স্বয়ংক্রিয়ভাবে পূরণ হয়।
  • Embedded ডকুমেন্ট Map<String, Object> হিসেবে আসে। টাইপড অ্যাক্সেস আর validation চাইলে সেগুলো ছোট ক্লাস দিয়ে বদলান।

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

MongoDB _id রাখলেও ফিল্ডের নাম কেন id?

Spring Data id নামের (বা @Id annotation দেওয়া) ফিল্ডকে স্বয়ংক্রিয়ভাবে _id-এ ম্যাপ করে, আর ObjectId-এর মতো দেখালে String-কে ObjectId-তে কনভার্ট করে। নিজে _id ডিক্লেয়ার করার দরকার নেই।

আমি কালেকশনের নাম device_logs রাখতে চাই।

শুধু স্ট্রিংটি এডিট করুন: @Document(collection = "device_logs")। জেনারেটর মডেলের নাম যেমন টাইপ করা হয়েছে তেমনই বসায়, তাই মডেলের নাম হিসেবে device_logs দিলে ক্লাসটিও DeviceLogs হয়ে যাবে।

এটি JPA entity থেকে কীভাবে আলাদা?

এটি @Entity, @Column আর @GeneratedValue-এর বদলে @Document, @Field আর Spring Data-র @Id ব্যবহার করে, এবং nested ভ্যালু JSON কলাম ছাড়াই embedded থাকে। রিলেশনাল টেবিলের জন্য JSON → Spring Boot JPA পেজ ব্যবহার করুন।