Converta JSON em class Java!

Insira JSON para gerar código class Java, incluindo objetos aninhados! Compatível com Jackson @JsonProperty, Lombok. Spring Boot JPA @Entity · MongoDB @Document: nas abas acima.
JSON
Resultado
 

Converta JSON em class Java!

Cole um JSON de exemplo e receba classes Java ou records que o Jackson consegue desserializar na hora. Objetos aninhados viram classes adicionais no mesmo arquivo, e arrays viram List<T>.

Use para os DTOs que você digitaria à mão no Spring Boot: tipos de resposta para clients RestTemplate, WebClient ou Feign, ou request bodies para APIs de terceiros. No Java 16+ dá para gerar records, e se a sua codebase já usa Lombok, a opção Lombok mantém a saída no mesmo estilo.

Como usar

  1. Cole o JSON da resposta da API na caixa de entrada.
  2. Informe o nome do DTO em Nome do tipo. Só a primeira classe é public, então use o mesmo nome do arquivo.
  3. Escolha class (com getters/setters) ou record em Estilo.
  4. Com class, marque Lombok para trocar os getters/setters por @Data, @NoArgsConstructor e @AllArgsConstructor.
  5. Cole o resultado num arquivo .java e adicione a declaração de package.

Exemplo

Entrada (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
Saída (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;
    }
}

Chaves snake_case como full_name são mapeadas para um campo fullName via @JsonProperty. private é keyword do Java, então o campo virou private_, enquanto os accessors continuam getPrivate()/setPrivate(), e o objeto owner foi separado numa classe Owner no mesmo arquivo.

Recursos suportados

  • Dois estilos de saída: uma class comum com getters/setters, ou um record imutável.
  • Opção Lombok (só no estilo class): adiciona @Data, @NoArgsConstructor, @AllArgsConstructor mais os imports e remove o código dos accessors.
  • @JsonProperty só é adicionado onde o nome do campo difere da chave JSON, junto com o import.
  • Todo campo usa um wrapper type (Integer, Long, Double, Boolean), então o null do JSON cabe sem trabalho extra.
  • Inteiros além do intervalo de 32 bits viram Long; valores de tipos misturados viram Object.
  • Chaves que são keywords, como class ou default, ganham um _ no final; chaves que começam com dígito ganham o prefixo n.
  • O Java não tem type alias, então um array no nível mais alto gera um comentário // Root: List<RootItem> mais a classe do elemento.

Casos de uso

DTOs para APIs de terceiros no Spring Boot

Cole a resposta de exemplo da documentação de uma API de pagamento, mapas ou mensageria e passe a classe gerada para restTemplate.getForObject(url, PaymentResponse.class). Quanto mais profundo o aninhamento, mais campos você deixa de esquecer em comparação com escrever à mão.

Models de resposta somente leitura como records

Para respostas que você só lê, um record é mais curto e não tem setters; o Jackson 2.12+ desserializa pelo construtor canônico do record.

Recuperar um model a partir de fixtures de teste

Num projeto legado em que só existem arquivos JSON de fixture, passe uma fixture para ver o layout dos campos e ter um primeiro rascunho do DTO.

Observações e limitações

  • Um campo que falta em alguns itens simplesmente chega como null no wrapper type; nada o marca como opcional. Adicione @NotNull ou algo parecido você mesmo se valida valores obrigatórios.
  • Com as configurações padrão, o Jackson lança exceção com chaves desconhecidas. Se a API pode ganhar campos novos, considere @JsonIgnoreProperties(ignoreUnknown = true) ou desativar o FAIL_ON_UNKNOWN_PROPERTIES.
  • Strings de data saem como String. Mapeá-las para LocalDateTime ou OffsetDateTime exige o módulo jackson-datatype-jsr310.
  • Escolher record esconde o checkbox do Lombok, já que records não precisam dele.
  • As classes aninhadas são package-private no mesmo arquivo, não public. Separe em arquivos próprios se outros packages precisarem delas.

Perguntas frequentes

Por que o getter de um campo booleano é getXxx e não isXxx?

O tipo do campo é o wrapper Boolean, não o primitivo boolean. Há muito tempo o Jackson só reconhece accessors isXxx para boolean primitivo, então é usado getXxx para a propriedade fazer bind do mesmo jeito em qualquer versão do Jackson.

A saída em record mantém o @JsonProperty?

Sim, componentes renomeados são escritos como @JsonProperty("full_name") String fullName. O Jackson 2.12 ou mais novo os preenche pelo construtor canônico.

Se eu definir spring.jackson.property-naming-strategy=SNAKE_CASE, posso apagar as anotações?

Com uma estratégia SNAKE_CASE global, full_name ↔ fullName é mapeado sem anotações. Nomes alterados por causa de keywords, como private_, não são cobertos pela estratégia, então mantenha essas anotações.

Posso usar a saída com o Gson?

O Gson ignora o @JsonProperty. Troque por @SerializedName na saída em class e a mesma estrutura funciona com o Gson; records são suportados a partir do Gson 2.10.