Menukar dokumen JSON kepada kelas @Document Spring Data MongoDB: koleksi yang dinamakan dalam @Document, medan @Id, medan private bagi setiap kunci dengan @Field apabila kunci yang disimpan berbeza, serta anotasi Lombok dan jakarta.validation, semuanya dalam satu fail Java.
Gunakannya apabila data yang masuk ke MongoDB sebagai JSON biasa (bacaan IoT, event, hasil scraping) perlu dibaca dan ditulis daripada servis Spring Boot melalui MongoRepository.
find().limit(5) dalam mongosh, membezakan medan sekali-sekala daripada medan yang tetap.Nama model (kosong bermaksud MyModel); ia digunakan untuk nama kelas dan juga koleksi dalam @Document(collection = "...").package, simpan fail, dan cipta repository yang mewarisi 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;
}firmware hanya muncul dalam dokumen kedua, jadi ia tiada anotasi. device_id dan recorded_at dibaca melalui @Field("device_id") dan @Field("recorded_at"), jadi dokumen sedia ada dipetakan ke medan camelCase tanpa migrasi.
@Document(collection = "DeviceLog").@Id private String id memegang _id MongoDB; kunci id atau _id dalam JSON anda digabungkan ke dalamnya dan tidak diulang, dan id numerik menjadikannya Long.Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (tarikh-masa) atau String; objek terbenam menjadi Map<String, Object> dan tatasusunan List<...>.@Field("...") ditambah setiap kali nama Java bukan kunci yang disimpan, termasuk kata kunci Java yang dinamakan semula dengan _ di hujung.@NotEmpty() untuk rentetan tidak kosong dan @NotNull() untuk yang lain; medan sekali-sekala atau null tidak mendapat apa-apa.Apabila bacaan yang ditulis peranti terus ke MongoDB perlu disajikan kepada dashboard, tampal beberapa dokumen untuk mendapat kelasnya dan terus isytiharkan derived query seperti findByDeviceIdOrderByRecordedAtDesc.
Jika Spring perlu membaca koleksi yang sudah ditulis oleh servis lain dalam snake_case, anotasi @Field membolehkan bahagian Java menggunakan nama camelCase sambil membaca dan menulis kunci yang sama.
@NotEmpty dan @NotNull tidak diperiksa semasa menyimpan secara lalai; daftarkan bean ValidatingMongoEventListener untuk mengesahkan sejurus sebelum save().LocalDateTime disimpan sebagai Date berasaskan UTC dalam MongoDB dan boleh kelihatan teranjak bergantung pada zon waktu pelayan. Untuk log yang memerlukan saat tepat, Instant lebih selamat.Long tidak dijana oleh MongoDB; anda mesti menetapkannya sebelum menyimpan. Hanya id String, ObjectId dan BigInteger diisi secara automatik.Map<String, Object>. Gantikan dengan kelas kecil apabila anda mahukan akses bertaip dan validasi.id sedangkan MongoDB menyimpan _id?Spring Data memetakan medan bernama id (atau beranotasi @Id) ke _id secara automatik dan menukar String kepada ObjectId apabila ia kelihatan seperti satu. Anda tidak perlu mengisytiharkan _id sendiri.
device_logs.Edit sahaja rentetannya: @Document(collection = "device_logs"). Penjana memasukkan nama model seperti yang ditaip, jadi memasukkan device_logs sebagai nama model juga akan menukar kelas kepada DeviceLogs.
Ia menggunakan @Document, @Field dan @Id Spring Data menggantikan @Entity, @Column dan @GeneratedValue, dan nilai bersarang kekal terbenam tanpa memerlukan lajur JSON. Untuk jadual hubungan, gunakan halaman JSON → Spring Boot JPA.