[자바 ORM 표준 JPA 프로그래밍 - 기본편] 2. 엔티티 매핑

김수현·2022년 9월 21일

목록 보기

2/9

해당 카테고리는 김영한님의 인프런 강의 '자바 ORM 표준 JPA 프로그래밍 - 기본편'을 듣고 내용을 정리하기 위한 것으로 자세한 설명은 해당 강의를 통해 확인할 수 있습니다.
https://www.inflearn.com/course/ORM-JPA-Basic/dashboard
ㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡ

📝 객체와 테이블 매핑

엔티티 매핑의 종류

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

이번 장에서는 먼저 객체와 테이블 매핑, 필드와 컬럼 매핑, 기본 키 매핑에 대해서 알아보고자 한다.

📜 객체와 테이블 매핑

@Entity

@Entity가 붙은 클래스는 JPA가 관리하며, 이를 엔티티라 한다.
JPA를 사용해서 테이블과 매핑할 클래스는 @Entity를 필수적으로 작성해야 한다.
주의
- 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
- final 클래스, enum, interface, inner 클래스 사용 X
- 저장할 필드에 final 사용 X
Entity 속성 정리
- name: JPA에서 사용할 엔티티 이름을 지정한다.
- 기본값: 클래스 이름을 그래도 사용(예: Member)
- 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

@Table

@Table은 엔티티와 매핑할 테이블을 지정할 때 사용한다.
ㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡ

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

JPA를 사용하면 DDL을 애플리케이션 실행 시점에 자동 생성할 수 있다.

이는 즉, 개발자가 테이블을 먼저 생성하고 객체를 구현할 필요 없이 객체만 먼저 구현해도 JPA가 알아서 테이블을 만들어준다는 것이다.(테이블 중심 -> 객체 중심)
이때 JPA는 데이터베이스 방언을 활용하여 데이터베이스에 맞는 적절한 DDL을 생성하게 된다.
다만 이렇게 생성된 DDL은 개발 장비에서만 사용하고, 운영 서버에서는 사용하지 않는 것이 좋다. 필요시에는 적절히 다듬은 후 사용하는 것을 권장한다.

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

hibernate.hbm2ddl.auto
create: 기존 테이블 삭제 후 다시 생성(DROP + CREATE)
create-drop: create와 같으나 종료 시점에 테이블 DROP
update: 변경분만 반영(운영 DB에는 사용하면 안됨)
validate: 엔티티와 테이블이 정상 매핑되었는지만 확인
none: 사용하지 않음

데이터베이스 스키마 자동 생성 - 주의

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

📜 DDL 생성 기능

제약조건 추가: 회원 이름은 필수, 10자 초과 X
- Column(nullable = true, length = 10)
유니크 제약조건 추가
- Column(unique = true)

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

ㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡ

📝 필드와 컬럼 매핑

예시를 들기 위해 요구사항을 먼저 추가해보도록 하자.

요구사항 추가

회원은 일반 회원과 관리자로 구분해야 한다.
회원 가입일과 수정일이 있어야 한다.
회원을 설명할 수 있는 필드가 있어야 한다. 이 필드는 길이 제한이 없다.

매핑 어노테이션 정리

@Column: 컬럼 매핑
- name: 필드와 매핑할 테이블의 컬럼 이름(기본값: 객체의 필드 이름)
- insertable, updatable: 등록, 변경 가능 여부(기본값: True)
- nullable: null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약 조건이 붙는다.
- unique: 한 컬럼에 간단히 유니크 제약 조건을 걸 때 사용한다.
  - 참고로 unique 속성 보다는 @Table의 uniqueConstraints 속성을 주로 사용하는 편임
- columnDefinition: 데이터베이스 컬럼 정보를 직접 줄 수 있다.
  - columnDefinition = "varchar(100) default 'EMPTY'"
- length: 문자 길이 제약 조건, String 타입에만 사용(기본값: 255)
- precision, scale: BigDecimal 타입에서 사용한다.(BigInteger도 사용할 수 있음) precision은 소수점을 포함한 전체 자릿 수를, scale은 소수의 자릿 수다.(기본값: precision = 19, scale = 2)
  - 참고로 double, float 타입에는 적용되지 않는다.
  - 아주 큰 숫자나 정밀한 소수를 다루어야 할 때만 사용한다.
@Temporal: 날짜 타입 매핑
- value
  - TemporalType.DATE: 날짜, 데이터베이스 data 타입과 매핑
  - TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑
  - TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이스 timestamp 타입과 매핑
- 참고
  - LocalDate, LocalDateTime을 사용할 경우 생략 가능(최신 하이버네이트 지원)
  - private LocalDate localDate;
  - private LocalDateTime localDateTime;
@Enumerated: enum 타입 매핑
- value(기본값: EnumType.ORDINAL)
  - EnumType.ORDINAL: enum 순서를 데이터베이스에 저장
  - EnumType.STRING: enum 이름을 데이터베이스에 저장
- 주의
  - 기본값인 ORDINAL은 사용하지 않는 것이 좋음
  - enum 타입에 데이터가 추가되어도 테이블에는 이것이 반영되지 않기 때문에 이를 순서로 저장할 경우 문제가 발생하게 됨.
  - 따라서 필수적으로 STRING을 사용할 것!
@Lob: BLOB, CLOB 매핑
- 지정할 수 있는 속성이 따로 없음
- 매핑하는 필드 타입이 문자이면 CLOB 매핑, 나머지는 BLOB 매핑
  - CLOB: String, char[], java.sql.CLOB
  - BLOB: byte[], java.sql.BLOB
@Transient: 특정 필드를 컬럼에 매핑하지 않음(무시)
- 데이터베이스에 저장, 조회 X
- 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용

ㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡ

📝 기본 키 매핑

기본 키 매핑 어노테이션

@Id
@GeneratedValue

기본 키 매핑 방법

직접 할당: @Id만 사용
자동 생성(@GeneratedValue)
- IDENTITY: 기본 키 생성을 데이터베이스에 위임
- SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용
- TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
- AUTO: 방언에 따라 자동 지정, 기본값

📜 IDENTITY

주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용
- ex) MySQL의 AUTO_INCREMENT
IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL을 실행하고 DB에서 식별자를 조회한다.
- JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL문을 실행한다.
- AUTO_INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID 값을 알 수 있다.
- 이 경우 즉시 SQL문을 날리지 않으면 객체를 영속성 컨텍스트의 1차 캐시에 저장할 수가 없게 됨.
  
  📜 SEQUENCE
데이터베이스 시퀀스란 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트이다.
- ex) 오라클 시퀀스
주로 Oracle, PostgreSQL, DB2, H2 데이터베이스에서 사용
@SequenceGenerator 필요
- name: 식별자 생성기 이름(필수)
- sequenceName: 데이터베이스에 등록되어 있는 시퀀스 이름(기본값: hibernate_sequence)
- initialValue: DDL 생성 시에만 사용됨, 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정(기본값: 1)
- allocationSize: 시퀀스 한 번 호출에 증가하는 수
  - 성능 최적화에 사용됨
  - 주의: 데이터베이스 시퀀스 값이 하나씩 증가하도록 설정되어 있으면 이 값을 반드시 1로 설정해야 함(기본값: 50)
- catalog, schema: 데이터베이스 catalog, schema 이름

📜 TABLE

키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략
- 장점: 모든 데이터베이스에 적용 가능
- 단점: 성능 하락
@TableGenerator 필요
- name: 식별자 생성기 이름(필수)
- table: 키생성 테이블 명(기본값: hibernate_sequences)
- pkColumnName: 시퀀스 컬럼명(기본값: sequence_name)
- valueColumnName: 시퀀스 값 컬럼명(기본값: next_val)
- pkColumnValue: 키로 사용할 값 이름(기본값: 엔티티 이름)
- initialValue: 초기 값, 마지막으로 생성된 값이 기준(기본값: 0)
- allocationSize: 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용, 기본값: 50)
- catalog, schema: 데이터베이스 catalog, schema 이름
- uniqueConstraints: 유니크 제약 조건 지정