[JPA] 엔티티 매핑

[김영한님의 자바 ORM 표준 JPA 프로그래밍을 학습 후 정리한 내용입니다.]

순서

1. 객체와 테이블 매핑
2. 필드와 컬럼 매핑
3. 기본 키 매핑

 

1. 객체와 테이블 매핑

@Entity

• @Entity가 붙은 클래스는 JPA가 관리, 엔티티라 한다.
• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity를 붙여야 한다.
• 기본 생성자는 필수다.
• 저장할 필드에 final을 사용하면 안된다.

@Table

• 엔티티와 매핑할 테이블을 지정한다. 생략하면 매핑한 엔티티 이름을 테이블 이름으로 사용한다.

 

2. 필드와 컬럼 매핑

@Column

옵션	설명
name	필드와 매핑할 테이블의 컬럼 이름
insertable, updatable	등록, 변경 가능 여부
nullable	null값 허용 여부
unique	@Table의 uniqueConstraint와 같지만 한 컬럼에 간단히 유니크 제약 조건을 걸때 사용
columnDefinition	데이터베이스 컬럼 정보를 직접 줄 수 있음.
length	문자 길이 제약 조건, String에만 사용

 

@Enumerated(EnumType.XXX)

@Enumerated(EnumType.STRING)
private Role role;

• EnumType.ORDINAL은 enum 순서를 데이터베이스에 저장한다.
• EnumType.STRING은 enum 이름 그대로 데이터베이스에 저장한다.

 

@Lob

@Lob
private byte[] content;

• 지정할 수 있는 속성이 없다
• 매핑하는 필드 타입이 문자면 CLOB, 나머지는 BLOB으로 매핑한다.

@Transient

@Transient
private String fullName;

• 필드 매핑 X
• 데이터베이스 저장, 조회 X
• 주로 메모리 상에서만 어떤 값을 보관하고 싶을 때 사용

@Access

@Entity
@Access(AccessType.FIELD)
public class Product {
    ...
}

• 필드 접근 : AccessType.FIELD로 지정한다. 필드에 직접 접근하며, 필드 접근 권한이 private 이어도 접근이 가능하다.
• 프로퍼티 접근 : AccessType.PROPERTY로 지정한다. 접근자(Getter)를 사용한다.

 

3. 기본 키 매핑

• 직접 할당 - @Id만 사용
• 자동 생성 - @GeneratedValue 사용

자동 생성 시 4가지 옵션

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

[IDENTITY 전략]

@Entity
public class Member {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

• 기본 키 생성을 데이터베이스에 위임하는 전략이다.
• 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용(예: MySQL의 AUTO_ INCREMENT)
• JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL을 실행한다.
• AUTO_ INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID 값을 알 수 있음. 따라서, IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL 실행하고 DB에서 식별자를 조회

 

[SEQUENCE 전략]

@Entity
@SequenceGenerator(
        name = “MEMBER_SEQ_GENERATOR",
        sequenceName = “MEMBER_SEQ", //매핑할 데이터베이스 시퀀스 이름
        initialValue = 1, allocationSize = 1)
public class Member {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE,
            generator = "MEMBER_SEQ_GENERATOR")
    private Long id;

• DB 시퀀스를 사용해서 기본키를 할당하는 방식이다.
• sequenceName 속성의 이름으로 MEMBER_SEQ를 지정했는데 JPA는 이 시퀀스 생성기를 실제 데이터베이스의 MEMBER_SEQ 시퀀스와 매핑한다.

 

[TABLE 전략]

@Entity
@TableGenerator(
	name = "MEMBER_SEQ_GENERATOR",
	table = ”MY_SEQUENCES",
	pkColumnValue = ”MEMBER_SEQ”, 
	allocationsize = 1)
public class Member {
	@Id
	@GeneratedValue(strategy = GenerationType.TABLE,
		generator = "MEMBER_SEQ_GENERATOR"
	)
	private Long id;

• TABLE 전략은 키 생성 전용 테이블을 하나 만든 다음, 여기에 이름과 값으로 사용할 컬럼을 만들어 데이터베이스 시퀀스를 흉내내는 전략이다.
• SELECT 쿼리를 사용하고 다음 값으로 증가시키기 위해 UPDATE 쿼리를 사용한다. 이 전략은 SEQUENCE 전략과 비교하여 데이터베이스와 한번 더 통신하는 단점이 있다.
• TABLE전략을 최적화하려면 TableGenerator.allocationSize를 사용하면 된다.

 

[AUTO 전략]

• 선택한 데이터베이스 방언에 따라 IDENTITY, SEQUENCE, TABLE 전략 중 하나를 자동으로 선택한다.
• 데이터베이스를 변경해도 코드를 수정할 필요가 없다는 장점이 있다.
• AUTO를 사용할 때 SEQUENCE나 TABLE 전략이 선택되면 시퀀스나 키 생성용 테이블을 미리 만들어야 한다.