Mengonversi dokumen JSON menjadi class @Document Spring Data MongoDB: collection yang disebut di @Document, field @Id, field private untuk setiap key dengan @Field jika key yang tersimpan berbeda, ditambah anotasi Lombok dan jakarta.validation, semuanya dalam satu file Java.
Gunakan ketika data yang masuk ke MongoDB sebagai JSON biasa (pembacaan IoT, event, hasil scraping) perlu dibaca dan ditulis dari service Spring Boot lewat MongoRepository.
find().limit(5) di mongosh, memisahkan field yang kadang muncul dari yang selalu ada.Nama model (kosong berarti MyModel); nama ini dipakai untuk nama class sekaligus collection di @Document(collection = "...").package, simpan file, lalu buat repository yang meng-extend 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 di dokumen kedua, jadi tidak diberi anotasi. device_id dan recorded_at dibaca lewat @Field("device_id") dan @Field("recorded_at"), sehingga dokumen yang sudah ada terpetakan ke field camelCase tanpa migrasi.
@Document(collection = "DeviceLog").@Id private String id menampung _id MongoDB; key id atau _id di JSON Anda digabungkan ke situ alih-alih diulang, dan id numerik menjadikannya Long.Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (tanggal-waktu) atau String; objek embedded menjadi Map<String, Object> dan array menjadi List<...>.@Field("...") ditambahkan setiap kali nama Java bukan key yang tersimpan, termasuk keyword Java yang diganti namanya dengan _ di belakang.@NotEmpty() untuk string tidak kosong dan @NotNull() untuk lainnya; field yang kadang muncul atau null tidak mendapat apa pun.Ketika data yang ditulis perangkat langsung ke MongoDB harus disajikan ke dashboard, tempel beberapa dokumen untuk mendapatkan class-nya dan langsung deklarasikan derived query seperti findByDeviceIdOrderByRecordedAtDesc.
Jika Spring perlu membaca collection yang sudah ditulis service lain dalam snake_case, anotasi @Field memungkinkan sisi Java memakai nama camelCase sambil membaca dan menulis key yang sama.
@NotEmpty dan @NotNull secara default tidak diperiksa saat menyimpan; daftarkan bean ValidatingMongoEventListener untuk memvalidasi tepat sebelum save().LocalDateTime disimpan sebagai Date berbasis UTC di MongoDB dan bisa tampak bergeser tergantung zona waktu server. Untuk log yang titik waktunya harus tepat, Instant lebih aman.Long tidak dibuat oleh MongoDB; Anda harus mengisinya sebelum menyimpan. Hanya id String, ObjectId dan BigInteger yang diisi otomatis.Map<String, Object>. Ganti dengan class kecil jika Anda ingin akses bertipe dan validasi.id padahal MongoDB menyimpan _id?Spring Data otomatis memetakan field bernama id (atau yang diberi anotasi @Id) ke _id dan mengonversi String menjadi ObjectId jika bentuknya cocok. Mendeklarasikan _id sendiri tidak diperlukan.
device_logs.Cukup edit string-nya: @Document(collection = "device_logs"). Generator memasukkan nama model persis seperti yang diketik, jadi mengisi device_logs sebagai nama model juga akan mengubah class menjadi DeviceLogs.
Class ini memakai @Document, @Field dan @Id milik Spring Data alih-alih @Entity, @Column dan @GeneratedValue, dan nilai bersarang tetap embedded tanpa butuh kolom JSON. Untuk tabel relasional, gunakan halaman JSON → Spring Boot JPA.