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

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

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

JSON documents को Spring Data MongoDB @Document class में बदलता है: @Document में नामित collection, @Id field, हर key के लिए private field और जहां stored key अलग हो वहां @Field, साथ में Lombok और jakarta.validation annotations, सब एक Java फ़ाइल में।

इसे तब इस्तेमाल करें जब MongoDB में सादे JSON के रूप में आने वाले data (IoT readings, events, scraping के परिणाम) को Spring Boot service से MongoRepository के ज़रिए पढ़ना-लिखना हो।

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

  1. Collection में मौजूद या आने वाले documents पेस्ट करें। कई documents array के रूप में पेस्ट करने पर, जैसे mongosh में find().limit(5) का आउटपुट, कभी-कभार वाले fields स्थायी fields से अलग पहचाने जाते हैं।
  2. मॉडल का नाम टाइप करें (खाली का मतलब MyModel); यह class नाम और @Document(collection = "...") की collection दोनों के लिए इस्तेमाल होता है।
  3. package line ठीक करें, फ़ाइल सेव करें, और 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 सिर्फ़ दूसरे document में है, इसलिए उस पर कोई annotation नहीं है। device_id और recorded_at @Field("device_id") और @Field("recorded_at") से पढ़े जाते हैं, इसलिए मौजूदा documents बिना migration के camelCase fields से map हो जाते हैं।

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

  • @Document(collection = "DeviceLog") से collection का नाम स्पष्ट रूप से देता है।
  • @Id private String id MongoDB का _id रखता है; आपके JSON की id या _id key दोहराई नहीं जाती बल्कि इसी में मिल जाती है, और numeric id इसे Long बना देता है।
  • हर field का type उसकी values से तय होता है: Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (date-times) या String; embedded objects Map<String, Object> और arrays List<...> बनते हैं।
  • जब भी Java नाम stored key न हो, @Field("...") जुड़ता है, अंत में _ लगाकर rename किए Java keywords समेत।
  • हर document में मौजूद fields को खाली न होने वाली strings के लिए @NotEmpty() और वरना @NotNull() मिलता है; कभी-कभार वाले या null fields को कुछ नहीं मिलता।

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

Sensor या log collections पर query APIs

जब devices जो readings सीधे MongoDB में लिखते हैं उन्हें dashboard पर दिखाना हो, तो कुछ documents पेस्ट करके class पाएं और तुरंत findByDeviceIdOrderByRecordedAtDesc जैसी derived queries declare करें।

Node.js service के साथ collection साझा करना

अगर Spring को ऐसी collection पढ़नी है जिसमें दूसरी service पहले से snake_case में लिखती है, तो @Field annotations Java की तरफ़ camelCase नाम रखते हुए उन्हीं keys को पढ़ने-लिखने देते हैं।

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

  • @NotEmpty और @NotNull default रूप से save पर जांचे नहीं जाते; save() से ठीक पहले validate करने के लिए ValidatingMongoEventListener bean register करें।
  • LocalDateTime MongoDB में UTC-आधारित Date के रूप में store होता है और server time zone के अनुसार खिसका हुआ दिख सकता है। जिन logs में सटीक क्षण मायने रखता है, उनके लिए Instant ज़्यादा सुरक्षित है।
  • Long id MongoDB नहीं बनाता; सेव करने से पहले आपको उसे assign करना होगा। सिर्फ़ String, ObjectId और BigInteger ids अपने-आप भरे जाते हैं।
  • Embedded documents Map<String, Object> के रूप में आते हैं। Typed access और validation चाहिए तो उन्हें छोटी classes से बदलें।

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

जब MongoDB _id store करता है तो field का नाम id क्यों है?

Spring Data id नाम वाले (या @Id लगे) field को अपने-आप _id से map करता है, और String ObjectId जैसा दिखे तो उसे ObjectId में बदलता है। _id खुद declare करना ज़रूरी नहीं।

मैं चाहता हूं कि collection का नाम device_logs हो।

बस string बदलें: @Document(collection = "device_logs")। Generator model नाम को जैसा टाइप किया वैसा डालता है, इसलिए model नाम के रूप में device_logs डालने पर class भी DeviceLogs बन जाएगी।

यह JPA entity से कैसे अलग है?

यह @Entity, @Column और @GeneratedValue की बजाय @Document, @Field और Spring Data का @Id इस्तेमाल करता है, और nested values को JSON column की ज़रूरत के बिना embedded ही रखा जाता है। Relational tables के लिए JSON → Spring Boot JPA पेज इस्तेमाल करें।