Converta JSON para esquema Spring Boot JPA!

Introduza JSON e converta-o para esquema Spring Boot JPA! Compatível com Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok.
JSON
Resultado
 

Converta JSON para esquema Spring Boot JPA!

Converte JSON numa classe @Entity para Spring Data JPA no Spring Boot 3. O arquivo Java único inclui os imports de jakarta.persistence e jakarta.validation, uma primary key @Id, um campo private por chave, os @Getter, @Setter e @FieldNameConstants do Lombok e os @NotEmpty/@NotNull do Bean Validation.

É voltado para o trabalho de backend em Spring Boot quando você precisa rápido de uma entity mapeada para uma tabela, partindo de um JSON de exemplo de um parceiro de integração ou da especificação de uma tela.

Como usar

  1. Cole um registro como objeto ou vários como array. Campos que faltam em algum registro não recebem anotação de validação.
  2. Informe o nome da classe da entity em Nome do modelo (padrão MyModel). A forma em minúscula também é usada no final do package (com.hello.world.reservation).
  3. Troque a linha package pelo package do seu projeto, salve como Reservation.java e crie um repository que estenda JpaRepository<Reservation, Long>.

Exemplo

Entrada (JSON)
{
  "guest_name": "Hana Lee",
  "room_no": 1204,
  "nights": 3,
  "rate": 149.5,
  "breakfast": true,
  "check_in": "2024-08-09T15:00:00"
}
Saída (Spring Data JPA)
package com.hello.world.reservation;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.NotNull;

import java.time.LocalDateTime;

import lombok.Getter;
import lombok.Setter;
import lombok.experimental.FieldNameConstants;

@Entity
@FieldNameConstants
@Getter
@Setter
public class Reservation {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @NotEmpty()
    @Column(name = "guest_name")
    private String guestName;

    @NotNull()
    @Column(name = "room_no")
    private Long roomNo;

    @NotNull()
    private Long nights;

    @NotNull()
    private Double rate;

    @NotNull()
    private Boolean breakfast;

    @NotNull()
    @Column(name = "check_in")
    private LocalDateTime checkIn;
}

Inteiros como room_no e nights viraram Long, rate virou Double e check_in, LocalDateTime. Cada chave snake_case recebe @Column(name = "...") e, como todos os valores estão preenchidos, o campo String guestName recebe @NotEmpty() e os outros, @NotNull().

Recursos suportados

  • Tipos Java: inteiros → Long, decimais → Double, booleanos → Boolean, YYYY-MM-DD → LocalDate, data e hora → LocalDateTime, outras strings (incluindo as só de dígitos) → String.
  • Objetos viram Map<String, Object> e arrays, List<...>, ambos anotados com @JdbcTypeCode(SqlTypes.JSON) para o Hibernate 6 guardá-los numa coluna JSON.
  • @Column(name = "guest_name") mantém a chave original como nome da coluna sempre que o nome do campo Java difere; chaves que são keywords do Java, como class, viram class_.
  • A primary key segue o seu JSON: sem id ou com id inteiro gera @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, e um id string gera um @Id private String id simples.
  • Campos sempre presentes recebem @NotEmpty() quando são strings não vazias e @NotNull() nos outros casos, já que o @NotEmpty só se aplica a strings e coleções.
  • O @FieldNameConstants do Lombok gera constantes de nome como Reservation.Fields.guestName.

Casos de uso

Jobs batch que guardam dados de API externa

Quando reservas ou pedidos de outro sistema precisam ser puxados periodicamente e salvos, um JSON de resposta já dá a entity, e o esqueleto do job batch em volta do saveAll() sai rápido.

Tabelas de desenvolvimento via `ddl-auto`

Com spring.jpa.hibernate.ddl-auto=update ativado localmente, o Hibernate cria a tabela a partir da entity gerada, então você pode carregar dados para o trabalho de UI na hora.

Observações e limitações

  • Os imports miram o Jakarta EE (Spring Boot 3, Hibernate 6). No Spring Boot 2, troque jakarta. de volta para javax. e substitua o @JdbcTypeCode por um converter, já que ele não existe no Hibernate 5.
  • 149.0 no JSON é lido como o mesmo número que 149, então vira Long. Um campo decimal precisa de um valor com parte fracionária no exemplo para sair como Double, e para dinheiro o BigDecimal é melhor.
  • Timestamps com offset, como 2024-08-09T15:00:00+09:00, perdem o offset no LocalDateTime. Use OffsetDateTime ou Instant quando o instante exato importa.
  • Colunas JSON exigem um banco que as tenha (MySQL 5.7+, PostgreSQL, H2 2.x). Para relações de verdade, troque o Map por uma classe @Embedded ou uma associação @OneToMany.

Perguntas frequentes

Por que colocar @Column(name = ...) em campos que o Spring mapearia para snake_case de qualquer jeito?

A naming strategy padrão do Spring Boot até transforma guestName em guest_name, mas isso quebra assim que uma chave não é snake_case simples ou a estratégia é trocada. O nome explícito mantém o mapeamento correto independente da configuração.

O @NotNull é aplicado ao salvar?

Com o spring-boot-starter-validation (Hibernate Validator) no classpath, o Hibernate roda o Bean Validation logo antes de persist e update e lança ConstraintViolationException. Sem ele, as anotações são ignoradas.

Para que serve o @FieldNameConstants?

O Lombok gera constantes string como Reservation.Fields.checkIn. Use em Sort.by(Reservation.Fields.checkIn) ou em queries Specification/Criteria no lugar de literais string, para que renomear um campo quebre o build em vez da query.