엔티티 매핑

@Entity

• @Entity가 붙은 클래스는 JPA가 관리하는 객체이며, 엔티티라고 부른다.
• 기본 생성자가 필수이다.
• final 클래스, enum, interface, inner 클래스 사용이 불가능하다.

name 속성

@Entity(name = "user")
public class Member {

}

• JPA에서 사용할 엔티티 이름을 지정한다.
• 기본값: 클래스 이름을 그대로 사용한다. (Member)
• 가급적 기본값을 사용하는 것을 권장한다.

@Table

• 엔티티와 매핑할 테이블을 지정한다.

@Table(name = "user")
@Entity
public class Member {

}

• name 속성은 매핑할 테이블의 이름을 지정하고, 기본값은 엔티티 이름을 그대로 사용한다.

@Column

• 엔티티 내의 필드 변수에 붙일 수 있다.

@Column(name = "username", nullable = false)
private String name;

@Column(name = "userAge")
private int age;

• name: 필드와 매핑할 테이블의 컬럼 이름
• nullable: null값의 허용 여부 결정

이외에 여러가지 속성이 존재하는데, 많이 사용하지 않으니 생략하겠다.

 

@Enumerated

• Java Enum 타입을 매핑할 때 사용하는 어노테이션이다.
• 속성에는 다음과 같이 두가지가 존재한다.

@Enumerated(value = EnumType.ORIGINAL)
private OrderStatus orderStatus;

@Enumerated(value = EnumType.STRING)
private DeliveryStatus deliveryStatus;

• EnumType.ORIGINAL: enum 순서를 데이터베이스에 저장한다.
• EnumType.STRING: enum 이름을 데이터베이스에 저장한다.
• 순서를 저장한다면 Enum 타입 안의 필드 순서를 저장하기 때문에 헷갈리고 혼란이 올 수 있다. 따라서 무조건 STRING 타입을 사용하자!

@Lob

• 데이터베이스 BLOB, CLOB 타입과 매핑한다. (크기가 큰 데이터를 저장한다)
• 지정할 수 있는 속성은 따로없다.

@Transient

• 엔티티 필드에 있는 멤버변수를 데이터베이스에 저장하고, 조회하고 싶지 않을 때 사용한다.
• 주로 메모리상에서만 임시로 값을 저장할 때 사용한다.

---

기본 키 매핑 어노테이션

• @Id
• @GeneratedValue

@Id @GeneratedValue(strategy = GenerationType.AUTO)
private Long id;

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

자동 생성 전략(@GeneratedValue)

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

IDENTITY 전략 - 특징

• 기본 키 생성을 데이터베이스에 위임하는 전략
• em.persist() 시점에 즉시 INSERT SQL을 실행하고 DB에서 식별자를 조회한다.

@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

SEQUENCE 전략 - 특징

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

@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;
}

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

TABLE 전략

• 키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략
• 모든 데이터베이스에 적용 가능
• 성능이 잘 나오지 않는다

TABLE 전략은 잘 사용하지 않으므로 예시코드를 생략하겠다.

 

권장하는 식별자 전략

• 기본 키 제약 조건: null 아님, 유일, 변하면 안된다.
• Long형 + 대체키 + 키 생성전략 사용