JSON을 springboot JPA schema로 변환하세요!

JSON을 입력하면 Spring Boot·Spring Data JPA 엔티티(@Entity, @Id, @GeneratedValue, Hibernate)로 변환합니다! Lombok @Getter·@Setter 포함.
JSON
결과
 

JSON을 springboot JPA schema로 변환하세요!

JSON을 Spring Boot 3의 Spring Data JPA용 @Entity 클래스로 바꿉니다. jakarta.persistence·jakarta.validation import, @Id 기본 키, 키마다 private 필드, Lombok의 @Getter·@Setter·@FieldNameConstants, Bean Validation의 @NotEmpty/@NotNull이 한 Java 파일에 들어갑니다.

연동사에서 받은 샘플 JSON이나 화면 명세에서 출발해 테이블과 매핑된 엔티티를 빨리 만들어야 하는 Spring Boot 백엔드 작업에 맞춰져 있습니다.

사용 방법

  1. 레코드 하나는 객체로, 여러 개는 배열로 붙여넣습니다. 어느 레코드에든 빠진 필드에는 검증 어노테이션이 붙지 않습니다.
  2. 모델 이름에 엔티티 클래스 이름을 적습니다(기본값 MyModel). 소문자로 바꾼 이름이 패키지 끝(com.hello.world.reservation)에도 쓰입니다.
  3. package 줄을 프로젝트 패키지로 고치고 Reservation.java로 저장한 뒤 JpaRepository<Reservation, Long>을 상속하는 리포지토리를 만듭니다.

예시

입력 (JSON)
{
  "guest_name": "Hana Lee",
  "room_no": 1204,
  "nights": 3,
  "rate": 149.5,
  "breakfast": true,
  "check_in": "2024-08-09T15:00:00"
}
출력 (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;
}

room_no, nights 같은 정수는 Long, rate는 Double, check_in은 LocalDateTime이 됐습니다. snake_case 키마다 @Column(name = "...")이 붙고, 모든 값이 채워져 있어서 String 필드 guestName에는 @NotEmpty(), 나머지에는 @NotNull()이 붙었습니다.

지원 기능

  • Java 타입: 정수 → Long, 소수 → Double, 불리언 → Boolean, YYYY-MM-DD → LocalDate, 날짜와 시간 → LocalDateTime, 나머지 문자열(숫자만 든 문자열 포함) → String.
  • 객체는 Map<String, Object>, 배열은 List<...>가 되고, 둘 다 @JdbcTypeCode(SqlTypes.JSON)이 붙어 Hibernate 6이 JSON 컬럼에 저장합니다.
  • Java 필드 이름이 JSON 키와 다르면 @Column(name = "guest_name")으로 원래 키를 컬럼 이름으로 유지합니다. class처럼 Java 예약어인 키는 class_가 됩니다.
  • 기본 키는 JSON을 따릅니다. id가 없거나 정수면 @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, 문자열이면 @Id private String id만 둡니다.
  • 항상 있는 필드에는 빈 문자열이 없는 문자열이면 @NotEmpty(), 그 외에는 @NotNull()을 붙입니다. @NotEmpty는 문자열과 컬렉션에만 쓸 수 있기 때문입니다.
  • Lombok @FieldNameConstants가 Reservation.Fields.guestName 같은 이름 상수를 만듭니다.

사용 사례

외부 API 데이터를 저장하는 배치

다른 시스템의 예약·주문을 주기적으로 받아 저장해야 할 때, 응답 JSON 하나로 엔티티를 만들고 나면 saveAll()을 중심으로 한 배치 골격은 금방 짤 수 있습니다.

`ddl-auto`로 개발용 테이블 만들기

로컬에서 spring.jpa.hibernate.ddl-auto=update를 켜 두면 Hibernate가 생성된 엔티티로 테이블을 만들어 주니, 화면 작업용 데이터를 바로 넣어 볼 수 있습니다.

주의사항

  • import는 Jakarta EE(Spring Boot 3, Hibernate 6) 기준입니다. Spring Boot 2라면 jakarta.를 javax.로 되돌리고, Hibernate 5에는 없는 @JdbcTypeCode 대신 컨버터를 쓰세요.
  • JSON의 149.0은 149와 같은 숫자로 파싱되어 Long이 됩니다. 소수 필드는 샘플에 소수점 이하 값이 있어야 Double로 나오고, 금액이라면 BigDecimal이 더 맞습니다.
  • 2024-08-09T15:00:00+09:00처럼 오프셋이 있는 시각은 LocalDateTime에서 오프셋을 잃습니다. 정확한 시점이 중요하면 OffsetDateTime이나 Instant를 쓰세요.
  • JSON 컬럼은 이를 지원하는 DB(MySQL 5.7 이상, PostgreSQL, H2)가 필요합니다. 실제 관계라면 Map 대신 @Embedded 클래스나 @OneToMany 연관관계로 바꾸세요.

자주 묻는 질문

Spring이 어차피 snake_case로 매핑하는데 @Column(name = ...)을 붙이는 이유는요?

Spring Boot 기본 네이밍 전략이 guestName을 guest_name으로 바꿔 주긴 하지만, 키가 단순한 snake_case가 아니거나 전략을 바꾸면 어긋납니다. 이름을 명시해 두면 설정과 상관없이 매핑이 맞습니다.

저장할 때 @NotNull이 실제로 검사되나요?

spring-boot-starter-validation(Hibernate Validator)이 클래스패스에 있으면 Hibernate가 persist·update 직전에 Bean Validation을 실행해 ConstraintViolationException을 던집니다. 없으면 어노테이션은 무시됩니다.

@FieldNameConstants는 어디에 쓰나요?

Lombok이 Reservation.Fields.checkIn 같은 문자열 상수를 만들어 줍니다. Sort.by(Reservation.Fields.checkIn)이나 Specification/Criteria 쿼리에서 문자열 리터럴 대신 쓰면, 필드 이름을 바꿨을 때 쿼리가 아니라 빌드가 먼저 깨집니다.