[TIL/JPA] 기본 개념 : 엔티티 매핑

1. 엔티티 매핑

- 객체와 테이블 매핑 : @Entity, @Table

- 필드와 컬럼 매핑 : @Column

- 기본키 매핑 : @Id

- 연관관계 매핑 : @ManyToOne, @JoinColumn(추후에 정리 예정!)

---

2. 객체와 테이블 매핑

1) @Entity

- @Entity가 붙은 클래스는 JPA가 관리하며, 엔티티라 한다.

- JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수이다.

 

!!주의!!

- 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)

- final 클래스, enum, interface, inner 클래스 사용할 수 없다.

- 저장할 필드에 final 사용할 수 없다.

 

2) @Entity 속성 정리

속성 : name

> JPA에서 사용할 엔티티 이름을 지정한다.

> 기본값 : 클래스 이름을 그대로 사용(ex. Member)

> 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

 

3) @Table

@Table은 엔티티와 매핑할 테이블을 지정하는 어노테이션이다.

속성	기능	기본값
name	매핑할 테이블 이름	엔티티 이름을 사용
catalog	데이터베이스 catalog 매핑
schema	데이터베이스 schema 매핑
uniqueConstraints(DDL)	DDL 생성 시에 유니크 제약 조건 생성

 

---

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

- DDL을 애플리케이션 실행 시점에 자동 생성

- 테이블 중심 -> 객체 중심

- 데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성

- 이렇게 생성된 DDL은 개발 장비에서만 사용

- 생성된 DDL은 운영서버에서 사용하지 않거나, 적절히 다듬은 후 사용

 

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

persistence.xml 파일에 아래 속성 값을 가지고 설정

hibernate.hbm2ddl.auto

옵션	설명
create	기존 테이블 삭제 후 다시 생성 (DROP + CREATE)
create-drop	create와 같으나 종료 시점에 테이블 DROP (테스트 케이스 확인 후 깔끔하게 지우고 싶을 때 사용)
update	변경분만 반영(운영 DB에서는 사용하면 안됨) ex) update로 설정하고, 엔티티에 컬럼을 하나 추가하면 drop을 하지 않고 alter로 쿼리문을 날려서 컬럼을 추가한다. 삭제는 할 수 없다.
validate	엔티티와 테이블이 정상 매핑되었는지만 확인 ex) Member 엔티티에 age라는 멤버 변수를 추가한 상태에서 테이블에는 해당 컬럼이 생기지 않았으면 실행시 에러가 발생한다.
none	해당 속성을 사용하지 않는다.

 

!!주의!!

- 운영 장비에는 절대 create, create-drop, update를 사용하면 안된다.

- 개발 초기 단계는 create 또는 update 설정

- 테스트 서버는 update 또는 validate 설정

- 스테이징과 운영 서버는 validate 또는 none 설정

 

2) DDL 생성 기능

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

JPA 런타임 동작에는 영향을 미지치 않고, 애플리케이션 실행시 JPA 엔티티의 매핑 정보를 이용해 DB 테이블을 만들 때는 실제 DB에 반영되는 것이라고 볼 수 있다.

 

- 제약조건 추가

ex) 회원 이름은 필수, 10자를 초과하면 안된다.

@Column(nullable = false, length = 10)

 

- 유니크 제약조건 추가

ex)

@Table(uniqueConstraints = {@UniqueConstraint(name = "NAME_AGE_UNIQUE", columnNames={"NAME", "AGE"})})

---

4. 필드와 컬럼 매핑

1) 매핑 어노테이션 정리

어노테이션	설명
@Column	컬럼 매핑
@Temporal	날짜 타입 매핑 * LocalDate, LocalDateTime 자료형을 사용할 때는 해당 어노테이션을 사용하지 않아도 된다.
@Enumerated	enum 타입 매핑 * 기본값은 ORDINAL ORDINAL은 enum 순서를 DB에 저장하고, STRING은 enum 이름을 DB에 저장한다.
@Lob	BLOB, CLOB 매핑 * 지정할 수 있는 속성이 없음. 매핑하는 필드 타입이 문자면 CLOB로 매핑한다. CLOB : String, char[], java.sql.CLOB BLOB : byte[], java.sql.BLOB
@Transient	특정 필드를 컬럼에 매핑하지 않음 * DB에 저장하지 않고 조회되지 않는다. 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용한다.

 

2) @Column

속성	설명	기본값
name	필드와 매핑할 테이블의 컬럼 이름	객체의 필드 이름
insertable, updatable	등록, 변경 가능 여부	TRUE
nullable(DDL)	null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.
unique(DDL)	@Table의 uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용한다.
columnDefinition(DDL)	DB 컬럼 정보를 직접 줄 수 있다. ex) varchar(50) default 'EMPTY'
length(DDL)	문자 길이 제약 조건, String 타입에만 사용한다.	255
precision, scale(DDL)	BigDecimal 타입에서 사용한다.(BigInteger도 사용) precision은 소수점을 포함한 전체 자릿 수를, scale은 소수의 자릿수이다.	precision=19 scale=2

---

5. 기본 키 매핑 방법

1) 직접 할당 : @Id만 사용

2) 자동 생성 : @GeneratedValue 

a) IDENTITY

- IDENTITY 전략은 기본 키 생성을 데이터베이스에 위임하는 전략이다.

- JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL을 실행하는데, IDENTITY 전략을 사용하는 경우 PK 값을 알 수 없어 persist() 시점에 즉시 INSERT SQL을 실행하고 DB에서 식별자를 조회하여 가져와 영속성 컨텍스트에 저장한다.

- MySQL, PostgreSQL, SQL Server, DB2에서 사용한다.

 

b) SEQUENCE

- SEQUENCE는 데이터베이스 시퀀스 오브젝트를 사용한다.

- 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트이며, 대표적으로 오라클의 시퀀스가 있다.

- 오라클, PostgreSQL, DB2, H2 데이터베이스에서 사용한다.

 

- SEQUENCE를 사용하려면 @SequenceGenerator 필요하다.

* @SequenceGenerator 속성

속성	설명	기본값
name	식별자 생성기 이름	필수
sequenceName	DB에 등록되어 있는 시퀀스 이름	hibernate_sequence
initialValue	DDL 생성 시에만 사용됨. 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정한다.	1
allocationSize	시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨) DB 시퀀스 값이 하나씩 증가하도록 설정되어 있으면 이 값을 반드시 1로 설정해야 한다.	50
catalog, schema	DB catalog, schema 이름

 

* allocationSize 관련 부가 설명

최초에 persist를 하면 1 -> 50으로 시퀀스 값이 증가한다. 대신에 하이버네이트가 메모리에 이 값을 기억하게 되고, 데이터베이스 호출 없이 메모리에서 50개의 시퀀스를 사용할 수 있는 것이다. 따라서 성능 최적화가 된다!

이렇게 해서 persist를 51번 정도 하게 되면 시퀀스를 호출해서 시퀀스 값을 100으로 증가한다. 그러면 하이버네이트는 이후 51~100까지 메모리에서 시퀀스를 할당하게된다.

main에서 호출을 계속하면 이상하게 증가한다고 느낄 수도 있는데 이것은 서버를 다시 시작하게 되는 것이라 시퀀스 값 중간에 구멍이 생기게 되는 것이다.

 

c) TABLE

- 키 생성용 테이블을 사용, 모든 DB에서 사용 가능하다. 단점으로는 성능이 있다.

- TABLE을 사용하려면 @TableGenerator 필요하다.

* @TableGenerator 속성

속성	설명	기본값
name	식별자 생성기 이름	필수
table	키생성 테이블명	hibernate_sequences
pkColumnName	시퀀스 컬럼명	sequence_name
valueColumnNa	시퀀스 값 컬럼명	next_val
pkColumnValue	키로 사용할 값 이름	엔티티 이름
initialValue	초기 값, 마지막으로 생성된 값이 기준이다.	0
allocationSize	시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨)	50
catalog, schema	DB catalog, schema 이름
uniqueConstraints(DDL)	유니크 제약 조건을 지정할 수 있다.

 

 

d) AUTO

- 방언에 따라 자동 지정, 기본 값이다.