Java Class → JSON Schema генератор

Ввод Java код

Загрузка редактора…

Вывод JSON Schema

Настройки

Выберите класс, который будет root при генерации схемы.

Парсинг выполняется полностью в браузере. Ваш код не покидает страницу.

Вставьте ваши Java классы, чтобы сразу получить JSON Schema.

Поддерживаются коллекции, вложенные объекты, Maps и популярные аннотации.

Как конвертировать классы и records Java в JSON Schema — пошаговая инструкция

Этот онлайн конвертер (Java class → JSON Schema) помогает генерировать JSON Schema из реальных моделей (DTOs, structs и classes), чтобы валидировать payloads, делиться контрактами и генерировать mock JSON.

  1. Шаг 1 — Вставьте исходник Java

    • Вставьте модели, которые хотите документировать, в левый редактор.
    • Добавьте все типы, на которые есть ссылки, в тот же сниппет, чтобы сгенерировались definitions.
    • Нажмите Пример, чтобы загрузить пример и увидеть ожидаемый формат.
  2. Шаг 2 — Выберите Корневой класс (если нужно)

    • Если найдено несколько definitions, выберите корневой тип, который соответствует вашему API payload.
    • Выходная схема строится вокруг выбранного root и может включать дополнительные definitions для связанных типов.
  3. Шаг 3 — Проверьте JSON Schema

    • Проверьте типы, required vs optional поля и вложенные структуры объектов/массивов.
    • Обратите внимание на definitions и $ref когда модели ссылаются друг на друга.
    • Скопируйте или скачайте схему для валидации, документации или schema-first разработки.
  4. Шаг 4 — Валидируйте или сгенерируйте mock JSON

    • Нажмите Сгенерировать мок-данные чтобы открыть Генератор моков с предзаполненной схемой.
    • Проверяйте реальные payloads по схеме, чтобы раньше замечать breaking changes.
    • Если вы используете продвинутую композицию схемы (например anyOf/oneOf/allOf), проверьте результат полноценным валидатором вроде Ajv.

Заметка о поддержке keywords

Сгенерированные схемы могут включать $ref и при необходимости можно добавить anyOf, oneOf, или allOf. Для сложных схем используйте полноценный JSON Schema validator и при необходимости сделайте dereference перед генерацией моков.

Связанные инструменты JSON Schema и генерации кода

Используйте эти инструменты, чтобы валидировать схемы, генерировать mock payloads, форматировать JSON-примеры и синхронизировать код и контракты.

Часто задаваемые вопросы

Какие Java конструкции поддерживаются?

Конвертер понимает POJOs, Lombok data classes, records, builders и DTOs с вложенными объектами, generics, массивами, Lists/Sets и Maps. Он учитывает аннотации @JsonProperty, @SerializedName, @JsonInclude и nullable hints, чтобы выровнять имена и optionality.

Насколько точна детекция типов?

Wrappers (Integer, Double, Boolean), Java time types, enums, Optionals и generic collections мапятся в ближайшие эквиваленты JSON Schema. Если информации не хватает (например raw List без generics), показываем предупреждение и используем разумные defaults.

Как превратить схему в mock JSON данные?

После генерации схемы нажмите "Сгенерировать мок-данные", чтобы открыть Генератор моков с предзаполненной схемой. Там можно настроить locale, размеры массивов и получить реалистичные payloads.

Как выбрать root класс, если классов несколько?

Откройте настройки и выберите класс из dropdown. По умолчанию выбирается первый public class, но можно переключаться на вложенные классы или DTOs без перезагрузки.

Java Class → JSON Schema генератор | JSONSwiss