Преобразуйте JSON в схему Spring Boot MongoDB!

Введите JSON и преобразуйте его в схему Spring Boot MongoDB! Поддержка: Spring Data MongoDB, @Document, @Id.
JSON
Результат
 

Преобразуйте JSON в схему Spring Boot MongoDB!

Преобразует JSON-документы в класс @Document для Spring Data MongoDB: коллекция, названная в @Document, поле @Id, private-поле на каждый ключ с @Field там, где хранимый ключ отличается, плюс аннотации Lombok и jakarta.validation — всё в одном Java-файле.

Используйте, когда данные, попадающие в MongoDB как обычный JSON (показания IoT, события, результаты скрейпинга), нужно читать и писать из сервиса на Spring Boot через MongoRepository.

Как пользоваться

  1. Вставьте документы, которые лежат или будут лежать в коллекции. Если вставить несколько массивом, например вывод find().limit(5) из mongosh, то эпизодические поля отделятся от постоянных.
  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 хранит _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 не получают ничего.

Сценарии использования

API запросов к коллекциям сенсоров или логов

Когда показания, которые устройства пишут прямо в MongoDB, нужно отдавать в дашборд, вставьте несколько документов, чтобы получить класс, и сразу объявляйте производные запросы вроде findByDeviceIdOrderByRecordedAtDesc.

Общая коллекция с сервисом на Node.js

Если Spring должен читать коллекцию, в которую другой сервис уже пишет в snake_case, аннотации @Field позволяют Java-стороне использовать имена в camelCase, читая и записывая те же ключи.

Примечания и ограничения

  • @NotEmpty и @NotNull по умолчанию при сохранении не проверяются; зарегистрируйте бин ValidatingMongoEventListener, чтобы валидировать прямо перед save().
  • LocalDateTime хранится в MongoDB как Date на основе UTC и может выглядеть сдвинутым в зависимости от часового пояса сервера. Для логов, где важен точный момент, надёжнее Instant.
  • id типа 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.

Чем это отличается от JPA-сущности?

Здесь используются @Document, @Field и @Id из Spring Data вместо @Entity, @Column и @GeneratedValue, а вложенные значения остаются встроенными, без JSON-колонки. Для реляционных таблиц используйте страницу JSON → Spring Boot JPA.