엔티티 매핑

객체와 관계형 데이터베이스를 어떻게 매핑하여 사용할지에 대한 고민

• 객체와 테이블 매핑: @Entity, @Table
• 필드와 컬럼 매핑: @Column
• 기본 키 매핑: @Id
• 연관관계 매핑: @ManyToOne, @JoinColumn

@Entity

• @Entity 가 붙은 클래스는 JPA 가 관리하는 엔티티라 한다.
• JPA 를 사용해서 테이블과 매핑할 클래스는 @Entity 를 필수적으로 작성해주어야 한다.
• 주의 사항
  • 기본 생성자 필수 (파라미터가 없는 public 또는 protected 생성자) - JPA 내부 메커니즘 활용하기 위한 리플렉션 등에서 사용
  • final 클래스, enum, interface, inner 클래스 사용하면 안된다.
  • 저장할 필드에 final 사용하면 안된다.

@Table

엔티티와 매핑할 테이블 지정

• 속성
  • name - 매핑할 테이블 이름
  • catalog - 데이버베이스 catalog 매핑
  • schema - 데이터베이스 schema 매핑
  • uniqueConstraints(DDL) - DDL 생성 시에 유니크 제약 조건 생성

데이터베이스 스키마 자동 생성

운영 단계가 아닌 개발 및 테스트 단계에서 활용

• DDL 을 애플리케이션 실행 시점에 자동 생성
• 테이블 중신 → 객체 중심
• 데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성
• 이렇게 생성된 DDL 은 개발 장비에서만 사용
• 생성된 DDL 은 운영서버에서는 사용하지 않거나, 적절히 다듬은 후 사용

hibernate.hbm2dd.auto

• create - 기존 테이블 삭제 후 다시 생성 (DROP + CREATE)
• create-drop - create 와 같으나, 종료시점에 테이블 DROP
• update - 변경문만 반영 (운영 DB에는 사용하면 안됌)
• validate - 엔티티와 테이블이 정상 매핑되었는지만 확인
• none - 사용하지 않음 / 위 기능을 주석처리와 동일

※ 주의 사항

• 운영 장비에는 절대 create, create-drop, update 사용하면 안된다.
• 개발 초기 단계는 create 또는 update
• 테스트 서버는 update 또는 validate
• 스테이징과 운영 서버는 validate 또는 none

개발하는 로컬 환경에서만 자유롭게 사용하고 테스트, 운영 등에선 가급적 사용 안하고 직접 쿼리 작성하여 사용하는 것이 좋다.

DDL 생성 기능

• 제약 조건 추가
  • @Column(nullabe = false, length = 10)
• 유니크 제약 조건 추가
  • @Table(uniqueConstraints = {@UniqueConstraint(name="", columnNames={""})})

DDL 생성 기능은 DDL 을 자동 생성할 때만 사용되고 JPA 의 실행 로직에는 영향을 주지 않는다.

 

필드와 컬럼 매핑

어노테이션	설명
@Column	컬럼 매핑
@Temporal	날짜 타입 매핑
@Enumerated	enum 타입 매핑
@Lob	BLOB, CLOB(String 일시) 매핑
@Transient	특정 필드를 컬럼에 매핑하지 않음 (매핑 무시)

@Column 속성

속성	설명	기본값
name	필드와 매핑할 테이블의 컬럼 이름	객체의 필드 이름
insertable, updatable	등록, 변경 가능 여부	TRUE
nullable(DDL)	null 값의 허용 여부를 설정한다. DDL 생성 시 유니크 제약조건 생성 (랜덤 이름 사용)	true
columnDefinition(DDL)	데이터베이스 컬럼 정보를 직접 줄 수 있다. 예) varchar(100) default ‘EMPTY'	필드의 자바 타입과 방언 정보를 사용
length(DDL)	문자 길이 제약 조건, String 타입에만 사용	255
precision, scale(DDL)	아주 큰 숫자 혹은 소수점 용도로 사용

@Enumerated - value 속성

자바 enum 타입을 매핑할 때 사용

• EnumType.ORDINAL - enum 순서를 데이터베이스에 저장 (기본값)
• EnumType.STRING - enum 이름을 데이터베이스에 저장

반드시 STRING 타입을 사용해야한다.
Enum 순서, 변경, 추가 기타 등에서 유연하게 대처 및 사용 가능

@Temporal

날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용

• TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑
 (예: 2013–10–11)
• TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑
 (예: 11:11:11)
• TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이 스 timestamp 타입과 매핑(예: 2013–10–11 11:11:11)

참고: LocalDate, LocalDateTime을 사용할 때는 생략 가능(최신 하이버네이트 지원)

@Lob

데이터베이스 BLOB, CLOB 타입과 매핑

• @Lob에는 지정할 수 있는 속성이 없다.
• 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑
  • CLOB: String, char[], java.sql.CLOB
  • BLOB: byte[], java.sql. BLOB

기본 키 매핑

• @Id
• @GenerativeValue

직접 할당하는 경우 @Id 만 사용

자동 생성하는 경우 @GenerativeValue

• IDENTITY: 데이터베이스에 위임, MYSQL
• SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE
  • @SequenceGenerator 필요
• TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
  • @TableGenerator 필요
• AUTO: 방언에 따라 자동 지정, 기본값

IDENTITY 전략 특징

• 기본 키 생성을 데이터베이스에 위임

• 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용
 (예: MySQL의 AUTO_ INCREMENT)

• JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL 실행

• AUTO_ INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID 값을 알 수 있음

• IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL 실행하고 DB에서 식별자를 조회

난 잘 모르겠으니, DB야 너가 알아서 해줘라는 의미를 생각하면 된다.

※ 주의사항 - IDENTITY 전략
IDENTITY 의 경우 앞서 살펴보았 듯이 실제 insert 를 수행해야만 해당 ID 값을 알 수 있기 때문에, 
영속성 컨텍스트 관리를 위해 예외적으로 persist() 수행 후 insert 쿼리를 수행하여 DB 가 생성한 ID 값을 가져온다.

SEQUENCE 전략 특징

• 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트(예: 오라클 시퀀스)
• 오라클, PostgreSQL, DB2, H2 데이터베이스에서 사용

String 타입이 아닌, Integer, Long 을 사용해줘야한다.
그렇지만, Integer 인 경우 10억 쯤 넘어가면 한바퀴 돌기 때문에 Long 사용을 권장한다.

사용자 정의가 필요한 경우 @SequenceGenerator 를 정의하여 사용하면 된다.

SequenceGenerator 예시

TABLE 전략

키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략

• 장점: 모든 데이터베이스에 적용 가능
• 단점: 성능 (직접 만들어 사용하기 때문에 최적화 문제 발생할 수 있음)

직접 만들어 사용하기보다 사용하는 DB 의 관례를 따르는 것이 좋다.

권장하는 식별자 전략

• 기본 키 제약 조건 - null 아님, 유일, 변하면 안된다.
• 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대체키)를 사용하자.
  • 대체키: 비즈니스 전략과 관련없는 자동 생성키를 의미
• 예를 들어 주민등록번호도 기본 키로 적절하기 않다.
• 권장: Long형 + 대체키 + 키 생성전략 사용 or UUID

비즈니스 적인 요소를 식별자로 사용하는 것은 권장하는 방법이 아니다.

※ 참고사항 - SEQUENCE, TABLE 전략 성능 최적화

allocationSize 속성을 통해 미리 어느정도 확보하여 DB Call 없이 식별자를 확보할 수 있다.

 

참조

• 해당 게시글은 김영한 강사님의 "자바 ORM 표준 JPA 프로그래밍 - 기본편" 을 바탕으로 작성되었습니다.
• 더 자세한 내용을 원하시는 경우 해당 강좌를 수강하시길 적극 추천드립니다.