Konversi JSON ke Skema Spring Boot MongoDB!

Masukkan JSON dan konversikan ke skema Spring Boot MongoDB! Mendukung Spring Data MongoDB, @Document, @Id.
JSON
Hasil
 

Konversi JSON ke Skema Spring Boot MongoDB!

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.

Cara menggunakan

  1. Tempel dokumen yang sudah atau akan ada di collection. Menempel beberapa sebagai array, seperti output find().limit(5) di mongosh, memisahkan field yang kadang muncul dari yang selalu ada.
  2. Ketik Nama model (kosong berarti MyModel); nama ini dipakai untuk nama class sekaligus collection di @Document(collection = "...").
  3. Perbaiki baris package, simpan file, lalu buat repository yang meng-extend 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 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.

Fitur yang didukung

  • Menyebutkan collection secara eksplisit dengan @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.
  • Setiap field diberi tipe dari nilainya sebagai 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.
  • Field yang ada di setiap dokumen mendapat @NotEmpty() untuk string tidak kosong dan @NotNull() untuk lainnya; field yang kadang muncul atau null tidak mendapat apa pun.

Kasus penggunaan

API query untuk collection sensor atau log

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.

Berbagi collection dengan service Node.js

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.

Catatan dan batasan

  • @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.
  • Id Long tidak dibuat oleh MongoDB; Anda harus mengisinya sebelum menyimpan. Hanya id String, ObjectId dan BigInteger yang diisi otomatis.
  • Dokumen embedded keluar sebagai Map<String, Object>. Ganti dengan class kecil jika Anda ingin akses bertipe dan validasi.

FAQ

Mengapa field-nya bernama 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.

Saya ingin collection-nya bernama 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.

Apa bedanya dengan entity JPA?

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.