Chuyển đổi JSON thành giải pháp Spring Boot MongoDB!

Nhập JSON và chuyển đổi nó thành giải pháp Spring Boot MongoDB! Hỗ trợ Spring Data MongoDB, @Document, @Id.
JSON
Kết quả
 

Chuyển đổi JSON thành giải pháp Spring Boot MongoDB!

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.

Cách sử dụng

  1. Dán các document đang có hoặc sẽ có trong collection. Dán nhiều document dưới dạng mảng, như output của find().limit(5) trong mongosh, giúp tách field thỉnh thoảng xuất hiện khỏi field luôn có.
  2. Gõ Tên model (để trống nghĩa là MyModel); nó được dùng cho cả tên class lẫn collection trong @Document(collection = "...").
  3. Sửa dòng package, lưu file, rồi tạo repository kế thừa MongoRepository<DeviceLog, String>.

Ví dụ

Đầu vào (JSON)
[
  { "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" }
]
Đầu ra (Spring Data MongoDB)
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.

Tính năng hỗ trợ

  • Đặt tên collection tường minh bằng @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.
  • Mỗi field được gán kiểu từ giá trị của nó là 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.
  • Field có mặt ở mọi document nhận @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ì.

Trường hợp sử dụng

API truy vấn trên collection cảm biến hoặc log

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.

Dùng chung collection với service Node.js

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.

Lưu ý và giới hạn

  • @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.
  • id kiểu 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.
  • Document nhúng ra dạng Map<String, Object>. Hãy thay bằng class nhỏ khi bạn muốn truy cập có kiểu và validate.

Câu hỏi thường gặp

Vì sao field tên là 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.

Tôi muốn collection tên là 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.

Khác gì so với entity JPA?

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.