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 백엔드 작업에 맞춰져 있습니다.
모델 이름에 엔티티 클래스 이름을 적습니다(기본값 MyModel). 소문자로 바꾼 이름이 패키지 끝(com.hello.world.reservation)에도 쓰입니다.package 줄을 프로젝트 패키지로 고치고 Reservation.java로 저장한 뒤 JpaRepository<Reservation, Long>을 상속하는 리포지토리를 만듭니다.{
"guest_name": "Hana Lee",
"room_no": 1204,
"nights": 3,
"rate": 149.5,
"breakfast": true,
"check_in": "2024-08-09T15:00:00"
}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()이 붙었습니다.
Long, 소수 → Double, 불리언 → Boolean, YYYY-MM-DD → LocalDate, 날짜와 시간 → LocalDateTime, 나머지 문자열(숫자만 든 문자열 포함) → String.Map<String, Object>, 배열은 List<...>가 되고, 둘 다 @JdbcTypeCode(SqlTypes.JSON)이 붙어 Hibernate 6이 JSON 컬럼에 저장합니다.@Column(name = "guest_name")으로 원래 키를 컬럼 이름으로 유지합니다. class처럼 Java 예약어인 키는 class_가 됩니다.id가 없거나 정수면 @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id, 문자열이면 @Id private String id만 둡니다.@NotEmpty(), 그 외에는 @NotNull()을 붙입니다. @NotEmpty는 문자열과 컬렉션에만 쓸 수 있기 때문입니다.@FieldNameConstants가 Reservation.Fields.guestName 같은 이름 상수를 만듭니다.다른 시스템의 예약·주문을 주기적으로 받아 저장해야 할 때, 응답 JSON 하나로 엔티티를 만들고 나면 saveAll()을 중심으로 한 배치 골격은 금방 짤 수 있습니다.
로컬에서 spring.jpa.hibernate.ddl-auto=update를 켜 두면 Hibernate가 생성된 엔티티로 테이블을 만들어 주니, 화면 작업용 데이터를 바로 넣어 볼 수 있습니다.
jakarta.를 javax.로 되돌리고, Hibernate 5에는 없는 @JdbcTypeCode 대신 컨버터를 쓰세요.149.0은 149와 같은 숫자로 파싱되어 Long이 됩니다. 소수 필드는 샘플에 소수점 이하 값이 있어야 Double로 나오고, 금액이라면 BigDecimal이 더 맞습니다.2024-08-09T15:00:00+09:00처럼 오프셋이 있는 시각은 LocalDateTime에서 오프셋을 잃습니다. 정확한 시점이 중요하면 OffsetDateTime이나 Instant를 쓰세요.Map 대신 @Embedded 클래스나 @OneToMany 연관관계로 바꾸세요.@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 쿼리에서 문자열 리터럴 대신 쓰면, 필드 이름을 바꿨을 때 쿼리가 아니라 빌드가 먼저 깨집니다.