Kino-convert ang mga JSON document sa isang Spring Data MongoDB @Document class: ang collection na pinangalanan sa @Document, isang @Id field, isang private field bawat key na may @Field kung saan iba ang naka-store na key, kasama ang mga annotation ng Lombok at jakarta.validation, lahat sa iisang Java file.
Gamitin ito kapag kailangang basahin at isulat mula sa isang Spring Boot service, gamit ang MongoRepository, ang data na pumapasok sa MongoDB bilang plain JSON (mga IoT reading, event, resulta ng scraping).
find().limit(5) sa mongosh, naihihiwalay ang mga paminsan-minsang field sa mga laging nandoon.Pangalan ng model (MyModel kapag blangko); ginagamit ito para sa class name at sa collection sa @Document(collection = "...").package, i-save ang file, at gumawa ng repository na nag-e-extend ng MongoRepository<DeviceLog, String>.[
{ "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;
}Nasa pangalawang document lang ang firmware, kaya wala itong annotation. Binabasa ang device_id at recorded_at sa pamamagitan ng @Field("device_id") at @Field("recorded_at"), kaya naka-map ang mga existing na document sa mga camelCase na field nang walang migration.
@Document(collection = "DeviceLog").@Id private String id ang _id ng MongoDB; isinasama rito ang id o _id key sa JSON mo sa halip na ulitin, at ginagawa itong Long ng numeric na id.Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (date-time) o String; nagiging Map<String, Object> ang mga embedded object at List<...> ang mga array.@Field("...") tuwing hindi ang naka-store na key ang Java name, kasama ang mga Java keyword na pinalitan ng pangalan na may _ sa dulo.@NotEmpty() ang mga field na nasa bawat document kapag hindi blangkong string, at @NotNull() kung hindi; walang nakukuha ang mga paminsan-minsan o null na field.Kapag kailangang ihain sa isang dashboard ang mga reading na direktang isinusulat ng mga device sa MongoDB, mag-paste ng ilang document para makuha ang class at agad na mag-declare ng mga derived query gaya ng findByDeviceIdOrderByRecordedAtDesc.
Kung kailangang basahin ng Spring ang isang collection na isinusulat na ng ibang service sa snake_case, hinahayaan ng mga @Field annotation na gumamit ng camelCase na pangalan ang panig ng Java habang binabasa at isinusulat ang parehong mga key.
@NotEmpty at @NotNull kapag nagse-save bilang default; mag-register ng ValidatingMongoEventListener bean para mag-validate bago mismo ang save().LocalDateTime bilang UTC-based na Date sa MongoDB at puwedeng mukhang naurong depende sa time zone ng server. Para sa mga log na mahalaga ang eksaktong sandali, mas ligtas ang Instant.Long na id; dapat mo itong i-assign bago mag-save. String, ObjectId at BigInteger na id lang ang awtomatikong napupunan.Map<String, Object> ang mga embedded document. Palitan sila ng maliliit na class kapag gusto mo ng typed na access at validation.id ang tawag sa field kung _id ang sine-save ng MongoDB?Awtomatikong mina-map ng Spring Data sa _id ang field na pinangalanang id (o may annotation na @Id) at kino-convert ang String sa ObjectId kapag mukha itong ganoon. Hindi na kailangang i-declare mo mismo ang _id.
device_logs ang pangalan ng collection.I-edit lang ang string: @Document(collection = "device_logs"). Isinisingit ng generator ang model name gaya ng pagkaka-type, kaya kapag inilagay mo ang device_logs bilang model name, magiging DeviceLogs din ang class.
Gumagamit ito ng @Document, @Field at @Id ng Spring Data sa halip na @Entity, @Column at @GeneratedValue, at nananatiling embedded ang mga nested value sa halip na mangailangan ng JSON column. Para sa mga relational table, gamitin ang page na JSON → Spring Boot JPA.