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 के ज़रिए पढ़ना-लिखना हो।
mongosh में find().limit(5) का आउटपुट, कभी-कभार वाले fields स्थायी fields से अलग पहचाने जाते हैं।मॉडल का नाम टाइप करें (खाली का मतलब MyModel); यह class नाम और @Document(collection = "...") की collection दोनों के लिए इस्तेमाल होता है।package line ठीक करें, फ़ाइल सेव करें, और MongoRepository<DeviceLog, String> को extend करने वाली repository बनाएं।[
{ "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" }
]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 बना देता है।Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (date-times) या String; embedded objects Map<String, Object> और arrays List<...> बनते हैं।@Field("...") जुड़ता है, अंत में _ लगाकर rename किए Java keywords समेत।@NotEmpty() और वरना @NotNull() मिलता है; कभी-कभार वाले या null fields को कुछ नहीं मिलता।जब devices जो readings सीधे MongoDB में लिखते हैं उन्हें dashboard पर दिखाना हो, तो कुछ documents पेस्ट करके class पाएं और तुरंत findByDeviceIdOrderByRecordedAtDesc जैसी derived queries declare करें।
अगर 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 अपने-आप भरे जाते हैं।Map<String, Object> के रूप में आते हैं। Typed access और validation चाहिए तो उन्हें छोटी classes से बदलें।_id store करता है तो field का नाम id क्यों है?Spring Data id नाम वाले (या @Id लगे) field को अपने-आप _id से map करता है, और String ObjectId जैसा दिखे तो उसे ObjectId में बदलता है। _id खुद declare करना ज़रूरी नहीं।
device_logs हो।बस string बदलें: @Document(collection = "device_logs")। Generator model नाम को जैसा टाइप किया वैसा डालता है, इसलिए model नाम के रूप में device_logs डालने पर class भी DeviceLogs बन जाएगी।
यह @Entity, @Column और @GeneratedValue की बजाय @Document, @Field और Spring Data का @Id इस्तेमाल करता है, और nested values को JSON column की ज़रूरत के बिना embedded ही रखा जाता है। Relational tables के लिए JSON → Spring Boot JPA पेज इस्तेमाल करें।