JSON 문서를 Spring Data MongoDB의 @Document 클래스로 바꿉니다. @Document에 컬렉션 이름, @Id 필드, 키마다 private 필드와 저장 키가 다를 때의 @Field, Lombok과 jakarta.validation 어노테이션이 한 Java 파일에 들어갑니다.
IoT 측정값, 이벤트, 크롤링 결과처럼 MongoDB에 그냥 JSON으로 쌓이는 데이터를 Spring Boot 서비스에서 MongoRepository로 읽고 써야 할 때 쓰세요.
mongosh의 find().limit(5) 결과처럼 여러 문서를 배열로 넣으면 가끔만 있는 필드와 항상 있는 필드가 구분됩니다.모델 이름을 입력합니다(비우면 MyModel). 클래스 이름과 @Document(collection = "...")의 컬렉션 이름에 함께 쓰입니다.package 줄을 고쳐 저장하고 MongoRepository<DeviceLog, String>을 상속하는 리포지토리를 만듭니다.[
{ "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" }
]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<...>가 됩니다.@Field("...")를 붙입니다. 뒤에 _를 붙여 이름을 바꾼 Java 예약어도 마찬가지입니다.@NotEmpty(), 그 외에는 @NotNull()이 붙고, 가끔 있거나 null인 필드에는 붙지 않습니다.기기가 MongoDB에 바로 쓰는 측정값을 대시보드에 내보내야 할 때, 문서 몇 개를 붙여넣어 클래스를 만들면 findByDeviceIdOrderByRecordedAtDesc 같은 파생 쿼리를 바로 선언할 수 있습니다.
다른 서비스가 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>로 나옵니다. 타입이 있는 접근과 검증이 필요하면 작은 클래스로 바꾸세요._id로 저장되는데 필드 이름이 id인 이유는요?Spring Data는 id라는 이름(또는 @Id가 붙은) 필드를 _id에 자동으로 매핑하고, ObjectId 모양의 String은 ObjectId로 바꿔 저장합니다. _id를 직접 선언할 필요가 없습니다.
device_logs로 하고 싶어요.문자열만 고치면 됩니다: @Document(collection = "device_logs"). 생성기는 입력한 모델 이름을 그대로 넣기 때문에, 모델 이름에 device_logs를 적으면 클래스 이름까지 DeviceLogs가 됩니다.
@Entity, @Column, @GeneratedValue 대신 @Document, @Field, Spring Data의 @Id를 쓰고, 중첩 값은 JSON 컬럼 없이 문서 안에 그대로 내장됩니다. 관계형 테이블이라면 JSON → Spring Boot JPA 페이지를 쓰세요.