JSON을 springboot MongoDB schema로 변환하세요!

JSON을 입력하면 Spring Boot·Spring Data MongoDB 도큐먼트 클래스(@Document, @Id)로 변환합니다!
JSON
결과
 

JSON을 springboot MongoDB schema로 변환하세요!

JSON 문서를 Spring Data MongoDB의 @Document 클래스로 바꿉니다. @Document에 컬렉션 이름, @Id 필드, 키마다 private 필드와 저장 키가 다를 때의 @Field, Lombok과 jakarta.validation 어노테이션이 한 Java 파일에 들어갑니다.

IoT 측정값, 이벤트, 크롤링 결과처럼 MongoDB에 그냥 JSON으로 쌓이는 데이터를 Spring Boot 서비스에서 MongoRepository로 읽고 써야 할 때 쓰세요.

사용 방법

  1. 컬렉션에 있거나 들어갈 문서를 붙여넣습니다. mongosh의 find().limit(5) 결과처럼 여러 문서를 배열로 넣으면 가끔만 있는 필드와 항상 있는 필드가 구분됩니다.
  2. 모델 이름을 입력합니다(비우면 MyModel). 클래스 이름과 @Document(collection = "...")의 컬렉션 이름에 함께 쓰입니다.
  3. package 줄을 고쳐 저장하고 MongoRepository<DeviceLog, String>을 상속하는 리포지토리를 만듭니다.

예시

입력 (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" }
]
출력 (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는 두 번째 문서에만 있어서 어노테이션이 없습니다. device_id와 recorded_at은 @Field("device_id"), @Field("recorded_at")으로 읽으므로, 기존 문서를 마이그레이션하지 않고도 camelCase 필드에 매핑됩니다.

지원 기능

  • @Document(collection = "DeviceLog")로 컬렉션 이름을 명시합니다.
  • @Id private String id가 MongoDB의 _id를 담습니다. JSON의 id나 _id 키는 따로 반복하지 않고 여기로 합치며, 숫자 id라면 Long이 됩니다.
  • 값을 보고 Long, Double, Boolean, LocalDate(YYYY-MM-DD), LocalDateTime(날짜와 시간), String 중 하나로 타입을 정하고, 내장 객체는 Map<String, Object>, 배열은 List<...>가 됩니다.
  • Java 이름이 저장 키와 다르면 @Field("...")를 붙입니다. 뒤에 _를 붙여 이름을 바꾼 Java 예약어도 마찬가지입니다.
  • 모든 문서에 있는 필드에는 빈 값이 없는 문자열이면 @NotEmpty(), 그 외에는 @NotNull()이 붙고, 가끔 있거나 null인 필드에는 붙지 않습니다.

사용 사례

센서·로그 컬렉션 조회 API

기기가 MongoDB에 바로 쓰는 측정값을 대시보드에 내보내야 할 때, 문서 몇 개를 붙여넣어 클래스를 만들면 findByDeviceIdOrderByRecordedAtDesc 같은 파생 쿼리를 바로 선언할 수 있습니다.

Node.js 서비스와 컬렉션 공유

다른 서비스가 snake_case로 쓰는 컬렉션을 Spring에서 읽어야 한다면, @Field 덕분에 Java 쪽은 camelCase 이름을 쓰면서도 같은 키를 읽고 씁니다.

주의사항

  • @NotEmpty, @NotNull은 기본 설정에서 저장할 때 검사되지 않습니다. save() 직전에 검증하려면 ValidatingMongoEventListener 빈을 등록하세요.
  • LocalDateTime은 MongoDB에 UTC 기준 Date로 저장되어 서버 시간대에 따라 어긋나 보일 수 있습니다. 정확한 시점이 중요한 로그라면 Instant가 안전합니다.
  • Long id는 MongoDB가 만들어 주지 않으므로 저장 전에 직접 넣어야 합니다. 자동으로 채워지는 건 String, ObjectId, BigInteger id뿐입니다.
  • 내장 문서는 Map<String, Object>로 나옵니다. 타입이 있는 접근과 검증이 필요하면 작은 클래스로 바꾸세요.

자주 묻는 질문

MongoDB에는 _id로 저장되는데 필드 이름이 id인 이유는요?

Spring Data는 id라는 이름(또는 @Id가 붙은) 필드를 _id에 자동으로 매핑하고, ObjectId 모양의 String은 ObjectId로 바꿔 저장합니다. _id를 직접 선언할 필요가 없습니다.

컬렉션 이름을 device_logs로 하고 싶어요.

문자열만 고치면 됩니다: @Document(collection = "device_logs"). 생성기는 입력한 모델 이름을 그대로 넣기 때문에, 모델 이름에 device_logs를 적으면 클래스 이름까지 DeviceLogs가 됩니다.

JPA 엔티티와 무엇이 다른가요?

@Entity, @Column, @GeneratedValue 대신 @Document, @Field, Spring Data의 @Id를 쓰고, 중첩 값은 JSON 컬럼 없이 문서 안에 그대로 내장됩니다. 관계형 테이블이라면 JSON → Spring Boot JPA 페이지를 쓰세요.