Преобразует JSON-документы в класс @Document для Spring Data MongoDB: коллекция, названная в @Document, поле @Id, private-поле на каждый ключ с @Field там, где хранимый ключ отличается, плюс аннотации Lombok и jakarta.validation — всё в одном Java-файле.
Используйте, когда данные, попадающие в MongoDB как обычный JSON (показания IoT, события, результаты скрейпинга), нужно читать и писать из сервиса на Spring Boot через MongoRepository.
find().limit(5) из mongosh, то эпизодические поля отделятся от постоянных.Имя модели (пустое означает 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 хранит _id из MongoDB; ключ id или _id в JSON сворачивается в него, а не повторяется, а числовой id делает его Long.Long, Double, Boolean, LocalDate (YYYY-MM-DD), LocalDateTime (дата-время) или String; встроенные объекты становятся Map<String, Object>, а массивы — List<...>.@Field("...") добавляется всякий раз, когда имя в Java не совпадает с хранимым ключом, включая ключевые слова Java, переименованные с _ на конце.@NotEmpty() для непустых строк и @NotNull() в остальных случаях; эпизодические поля и поля с null не получают ничего.Когда показания, которые устройства пишут прямо в MongoDB, нужно отдавать в дашборд, вставьте несколько документов, чтобы получить класс, и сразу объявляйте производные запросы вроде findByDeviceIdOrderByRecordedAtDesc.
Если Spring должен читать коллекцию, в которую другой сервис уже пишет в snake_case, аннотации @Field позволяют Java-стороне использовать имена в camelCase, читая и записывая те же ключи.
@NotEmpty и @NotNull по умолчанию при сохранении не проверяются; зарегистрируйте бин ValidatingMongoEventListener, чтобы валидировать прямо перед save().LocalDateTime хранится в MongoDB как Date на основе UTC и может выглядеть сдвинутым в зависимости от часового пояса сервера. Для логов, где важен точный момент, надёжнее Instant.Long MongoDB не генерирует; его нужно присвоить до сохранения. Автоматически заполняются только id типа String, ObjectId и BigInteger.Map<String, Object>. Замените их небольшими классами, если нужны типизированный доступ и валидация.id, если MongoDB хранит _id?Spring Data автоматически сопоставляет поле с именем id (или с аннотацией @Id) с _id и преобразует String в ObjectId, если строка на него похожа. Объявлять _id самому не нужно.
device_logs.Просто отредактируйте строку: @Document(collection = "device_logs"). Генератор вставляет имя модели как введено, так что ввод device_logs в качестве имени модели превратил бы и класс в DeviceLogs.
Здесь используются @Document, @Field и @Id из Spring Data вместо @Entity, @Column и @GeneratedValue, а вложенные значения остаются встроенными, без JSON-колонки. Для реляционных таблиц используйте страницу JSON → Spring Boot JPA.