I-convert ang JSON sa Spring Boot MongoDB Schema!

Ipasok ang JSON at i-convert ito sa Spring Boot MongoDB Schema! Sinusuportahan ang Spring Data MongoDB, @Document, @Id.
JSON
Resulta
 

I-convert ang JSON sa Spring Boot MongoDB Schema!

Kino-convert ang mga JSON document sa isang Spring Data MongoDB @Document class: ang collection na pinangalanan sa @Document, isang @Id field, isang private field bawat key na may @Field kung saan iba ang naka-store na key, kasama ang mga annotation ng Lombok at jakarta.validation, lahat sa iisang Java file.

Gamitin ito kapag kailangang basahin at isulat mula sa isang Spring Boot service, gamit ang MongoRepository, ang data na pumapasok sa MongoDB bilang plain JSON (mga IoT reading, event, resulta ng scraping).

Paano gamitin

  1. I-paste ang mga document na nasa collection o ilalagay pa lang doon. Kapag ilan ang i-paste bilang array, gaya ng output ng find().limit(5) sa mongosh, naihihiwalay ang mga paminsan-minsang field sa mga laging nandoon.
  2. Mag-type ng Pangalan ng model (MyModel kapag blangko); ginagamit ito para sa class name at sa collection sa @Document(collection = "...").
  3. Ayusin ang linyang package, i-save ang file, at gumawa ng repository na nag-e-extend ng MongoRepository<DeviceLog, String>.

Halimbawa

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;
}

Nasa pangalawang document lang ang firmware, kaya wala itong annotation. Binabasa ang device_id at recorded_at sa pamamagitan ng @Field("device_id") at @Field("recorded_at"), kaya naka-map ang mga existing na document sa mga camelCase na field nang walang migration.

Mga sinusuportahang feature

  • Tahasang pinapangalanan ang collection gamit ang @Document(collection = "DeviceLog").
  • Hawak ng @Id private String id ang _id ng MongoDB; isinasama rito ang id o _id key sa JSON mo sa halip na ulitin, at ginagawa itong Long ng numeric na id.
  • May type ang bawat field mula sa mga value nito bilang Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (date-time) o String; nagiging Map<String, Object> ang mga embedded object at List<...> ang mga array.
  • Idinadagdag ang @Field("...") tuwing hindi ang naka-store na key ang Java name, kasama ang mga Java keyword na pinalitan ng pangalan na may _ sa dulo.
  • Nakakakuha ng @NotEmpty() ang mga field na nasa bawat document kapag hindi blangkong string, at @NotNull() kung hindi; walang nakukuha ang mga paminsan-minsan o null na field.

Mga gamit

Mga query API para sa sensor o log collection

Kapag kailangang ihain sa isang dashboard ang mga reading na direktang isinusulat ng mga device sa MongoDB, mag-paste ng ilang document para makuha ang class at agad na mag-declare ng mga derived query gaya ng findByDeviceIdOrderByRecordedAtDesc.

Pagbabahagi ng collection sa isang Node.js service

Kung kailangang basahin ng Spring ang isang collection na isinusulat na ng ibang service sa snake_case, hinahayaan ng mga @Field annotation na gumamit ng camelCase na pangalan ang panig ng Java habang binabasa at isinusulat ang parehong mga key.

Mga paalala at limitasyon

  • Hindi sinusuri ang @NotEmpty at @NotNull kapag nagse-save bilang default; mag-register ng ValidatingMongoEventListener bean para mag-validate bago mismo ang save().
  • Sine-save ang LocalDateTime bilang UTC-based na Date sa MongoDB at puwedeng mukhang naurong depende sa time zone ng server. Para sa mga log na mahalaga ang eksaktong sandali, mas ligtas ang Instant.
  • Hindi ginagawa ng MongoDB ang Long na id; dapat mo itong i-assign bago mag-save. String, ObjectId at BigInteger na id lang ang awtomatikong napupunan.
  • Lumalabas bilang Map<String, Object> ang mga embedded document. Palitan sila ng maliliit na class kapag gusto mo ng typed na access at validation.

Mga madalas itanong

Bakit id ang tawag sa field kung _id ang sine-save ng MongoDB?

Awtomatikong mina-map ng Spring Data sa _id ang field na pinangalanang id (o may annotation na @Id) at kino-convert ang String sa ObjectId kapag mukha itong ganoon. Hindi na kailangang i-declare mo mismo ang _id.

Gusto kong device_logs ang pangalan ng collection.

I-edit lang ang string: @Document(collection = "device_logs"). Isinisingit ng generator ang model name gaya ng pagkaka-type, kaya kapag inilagay mo ang device_logs bilang model name, magiging DeviceLogs din ang class.

Paano ito naiiba sa isang JPA entity?

Gumagamit ito ng @Document, @Field at @Id ng Spring Data sa halip na @Entity, @Column at @GeneratedValue, at nananatiling embedded ang mga nested value sa halip na mangailangan ng JSON column. Para sa mga relational table, gamitin ang page na JSON → Spring Boot JPA.