Tukarkan JSON kepada Spring Boot MongoDB!

Masukkan JSON dan tukarkannya kepada Spring Boot MongoDB! Menyokong Spring Data MongoDB, @Document, @Id.
JSON
Hasil
 

Tukarkan JSON kepada Spring Boot MongoDB!

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.

Cara menggunakan

  1. Tampal dokumen yang ada atau akan ada dalam koleksi. Menampal beberapa dokumen sebagai tatasusunan, seperti output find().limit(5) dalam mongosh, membezakan medan sekali-sekala daripada medan yang tetap.
  2. Taip Nama model (kosong bermaksud MyModel); ia digunakan untuk nama kelas dan juga koleksi dalam @Document(collection = "...").
  3. Betulkan baris package, simpan fail, dan cipta repository yang mewarisi MongoRepository<DeviceLog, String>.

Contoh

Input (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" }
]
Output (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 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.

Ciri yang disokong

  • Menamakan koleksi secara eksplisit dengan @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.
  • Setiap medan diberi jenis berdasarkan nilainya sebagai 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.
  • Medan yang ada dalam setiap dokumen mendapat @NotEmpty() untuk rentetan tidak kosong dan @NotNull() untuk yang lain; medan sekali-sekala atau null tidak mendapat apa-apa.

Kes penggunaan

API query bagi koleksi sensor atau log

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.

Berkongsi koleksi dengan servis Node.js

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.

Nota dan had

  • @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.
  • Id Long tidak dijana oleh MongoDB; anda mesti menetapkannya sebelum menyimpan. Hanya id String, ObjectId dan BigInteger diisi secara automatik.
  • Dokumen terbenam dijana sebagai Map<String, Object>. Gantikan dengan kelas kecil apabila anda mahukan akses bertaip dan validasi.

Soalan lazim

Mengapa medan itu dinamakan 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.

Saya mahu koleksi itu dinamakan 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.

Apakah bezanya dengan entity JPA?

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.