Chuyển document JSON thành class @Document của Spring Data MongoDB: collection được đặt tên trong @Document, một field @Id, mỗi key một field private kèm @Field ở chỗ key lưu trữ khác tên, cùng annotation của Lombok và jakarta.validation, tất cả trong một file Java.
Dùng nó khi dữ liệu đổ vào MongoDB dưới dạng JSON thuần (số đo IoT, event, kết quả scraping) cần được đọc và ghi từ service Spring Boot qua MongoRepository.
find().limit(5) trong mongosh, giúp tách field thỉnh thoảng xuất hiện khỏi field luôn có.Tên model (để trống nghĩa là MyModel); nó được dùng cho cả tên class lẫn collection trong @Document(collection = "...").package, lưu file, rồi tạo repository kế thừa 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 chỉ xuất hiện ở document thứ hai nên không có annotation. device_id và recorded_at được đọc qua @Field("device_id") và @Field("recorded_at"), nên document có sẵn ánh xạ vào field camelCase mà không cần migration.
@Document(collection = "DeviceLog").@Id private String id giữ _id của MongoDB; key id hoặc _id trong JSON được gộp vào đó thay vì lặp lại, và id dạng số làm nó thành Long.Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (ngày giờ) hoặc String; object nhúng thành Map<String, Object> và mảng thành List<...>.@Field("...") được thêm mỗi khi tên Java không phải key lưu trữ, kể cả từ khóa Java bị đổi tên với _ ở cuối.@NotEmpty() với chuỗi không rỗng và @NotNull() với trường hợp khác; field thỉnh thoảng có hoặc là null không nhận gì.Khi số đo mà thiết bị ghi thẳng vào MongoDB cần được phục vụ cho dashboard, dán vài document để có class rồi khai báo ngay các derived query như findByDeviceIdOrderByRecordedAtDesc.
Nếu Spring cần đọc collection mà service khác đã ghi theo snake_case, annotation @Field cho phép phía Java dùng tên camelCase trong khi vẫn đọc ghi cùng các key.
@NotEmpty và @NotNull mặc định không được kiểm tra khi lưu; hãy đăng ký bean ValidatingMongoEventListener để validate ngay trước save().LocalDateTime được lưu thành Date theo UTC trong MongoDB và có thể bị lệch tùy múi giờ của server. Với log mà thời điểm chính xác là quan trọng, Instant an toàn hơn.Long không được MongoDB tự sinh; bạn phải gán trước khi lưu. Chỉ id kiểu String, ObjectId và BigInteger mới được tự điền.Map<String, Object>. Hãy thay bằng class nhỏ khi bạn muốn truy cập có kiểu và validate.id trong khi MongoDB lưu _id?Spring Data tự động ánh xạ field tên id (hoặc có @Id) sang _id và chuyển String thành ObjectId khi nó trông giống ObjectId. Không cần tự khai báo _id.
device_logs.Chỉ cần sửa chuỗi: @Document(collection = "device_logs"). Công cụ chèn tên model đúng như đã gõ, nên nhập device_logs làm tên model cũng sẽ biến class thành DeviceLogs.
Nó dùng @Document, @Field và @Id của Spring Data thay cho @Entity, @Column và @GeneratedValue, và giá trị lồng nhau vẫn được nhúng thay vì cần cột JSON. Với bảng quan hệ, hãy dùng trang JSON → Spring Boot JPA.