Преобразуйте JSON в class Java!

Введите JSON, чтобы получить код class на Java, включая вложенные объекты! Поддержка: Jackson @JsonProperty, Lombok. Spring Boot JPA @Entity · MongoDB @Document — во вкладках выше.
JSON
Результат
 

Преобразуйте JSON в class Java!

Вставьте пример JSON и получите классы Java или record, которые Jackson сможет десериализовать сразу. Вложенные объекты становятся дополнительными классами в том же файле, а массивы — List<T>.

Используйте для DTO, которые иначе пришлось бы набирать вручную в Spring Boot: типов ответов для клиентов RestTemplate, WebClient или Feign, или тел запросов к сторонним API. На Java 16+ можно генерировать record, а если в кодовой базе уже используется Lombok, опция Lombok сохранит тот же стиль вывода.

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

  1. Вставьте JSON ответа API в поле ввода.
  2. Введите имя DTO в Имя типа. public будет только первый класс, так что согласуйте его с именем файла.
  3. В Стиль выберите class (с геттерами/сеттерами) или record.
  4. Для class отметьте Lombok, чтобы заменить геттеры/сеттеры на @Data, @NoArgsConstructor и @AllArgsConstructor.
  5. Вставьте результат в файл .java и добавьте объявление пакета.

Пример

Вход (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
Результат (Java · class)
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

public class Repository {
    private Integer id;
    @JsonProperty("full_name") private String fullName;
    @JsonProperty("private") private Boolean private_;
    @JsonProperty("stargazers_count") private Integer stargazersCount;
    private Owner owner;
    private List<String> topics;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getFullName() {
        return fullName;
    }

    public void setFullName(String fullName) {
        this.fullName = fullName;
    }

    public Boolean getPrivate() {
        return private_;
    }

    public void setPrivate(Boolean private_) {
        this.private_ = private_;
    }

    public Integer getStargazersCount() {
        return stargazersCount;
    }

    public void setStargazersCount(Integer stargazersCount) {
        this.stargazersCount = stargazersCount;
    }

    public Owner getOwner() {
        return owner;
    }

    public void setOwner(Owner owner) {
        this.owner = owner;
    }

    public List<String> getTopics() {
        return topics;
    }

    public void setTopics(List<String> topics) {
        this.topics = topics;
    }
}

class Owner {
    private String login;
    @JsonProperty("site_admin") private Boolean siteAdmin;

    public String getLogin() {
        return login;
    }

    public void setLogin(String login) {
        this.login = login;
    }

    public Boolean getSiteAdmin() {
        return siteAdmin;
    }

    public void setSiteAdmin(Boolean siteAdmin) {
        this.siteAdmin = siteAdmin;
    }
}

Ключи в snake_case, такие как full_name, сопоставляются с полем fullName через @JsonProperty. private — ключевое слово Java, поэтому поле стало private_, а аксессоры остались getPrivate()/setPrivate(); объект owner вынесен в класс Owner в том же файле.

Возможности

  • Два стиля вывода: обычный class с геттерами/сеттерами или неизменяемый record.
  • Опция Lombok (только для стиля class): добавляет @Data, @NoArgsConstructor, @AllArgsConstructor с импортами и убирает код аксессоров.
  • @JsonProperty вместе с импортом добавляется только там, где имя поля отличается от ключа JSON.
  • Все поля используют типы-обёртки (Integer, Long, Double, Boolean), так что JSON null помещается без дополнительных усилий.
  • Целые за пределами 32-битного диапазона становятся Long; значения смешанных типов — Object.
  • Ключи-ключевые слова вроде class или default получают _ в конце; ключи, начинающиеся с цифры, — префикс n.
  • В Java нет псевдонимов типов, поэтому массив верхнего уровня даёт комментарий // Root: List<RootItem> и класс элемента.

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

DTO для сторонних API в Spring Boot

Вставьте пример ответа из документации API платежей, карт или мессенджера и передайте сгенерированный класс в restTemplate.getForObject(url, PaymentResponse.class). Чем глубже вложенность, тем больше полей вы не пропустите по сравнению с ручным набором.

Модели ответов только для чтения в виде records

Для ответов, которые вы только читаете, record короче и не имеет сеттеров; Jackson 2.12+ десериализует через канонический конструктор record.

Восстановление модели по тестовым фикстурам

В legacy-проекте, где остались только JSON-файлы фикстур, подайте фикстуру на вход, чтобы увидеть раскладку полей и получить первый черновик DTO.

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

  • Поле, отсутствующее в части элементов, просто приходит как null в типе-обёртке; ничто не помечает его как необязательное. Если вы валидируете обязательные значения, добавьте @NotNull или аналог сами.
  • С настройками по умолчанию Jackson выбрасывает исключение на неизвестных ключах. Если API может добавлять поля, рассмотрите @JsonIgnoreProperties(ignoreUnknown = true) или отключение FAIL_ON_UNKNOWN_PROPERTIES.
  • Строки с датами выводятся как String. Для отображения в LocalDateTime или OffsetDateTime нужен модуль jackson-datatype-jsr310.
  • При выборе record флажок Lombok скрывается, так как records в нём не нуждаются.
  • Вложенные классы — package-private классы в том же файле, а не public. Если они нужны другим пакетам, разнесите их по отдельным файлам.

Частые вопросы

Почему геттер булева поля называется getXxx, а не isXxx?

Тип поля — обёртка Boolean, а не примитив boolean. Jackson издавна распознаёт аксессоры isXxx только для примитивного boolean, поэтому используется getXxx, чтобы свойство одинаково привязывалось в любой версии Jackson.

Сохраняется ли @JsonProperty в выводе record?

Да, переименованные компоненты записываются как @JsonProperty("full_name") String fullName. Jackson 2.12 и новее заполняет их через канонический конструктор.

Если задать spring.jackson.property-naming-strategy=SNAKE_CASE, можно удалить аннотации?

С глобальной стратегией SNAKE_CASE full_name ↔ fullName сопоставляются без аннотаций. Имена, изменённые из-за ключевых слов, вроде private_, стратегией не покрываются, так что эти аннотации оставьте.

Можно ли использовать вывод с Gson?

Gson игнорирует @JsonProperty. Замените её на @SerializedName в выводе class, и та же структура заработает с Gson; records поддерживаются начиная с Gson 2.10.