[JPA] 기본 엔티티 매핑

김영한님의 자바 ORM 표준 JPA 프로그래밍 - 기본편 정리

1. 객체와 테이블 매핑

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

- 필드와 컬럼 매핑 : @Column

- 기본 키 매핑 : @Id

- 연관관계 매핑 : @ManyToOne, @JoinColumn

 

2. @Entity

- @Entity가 붙은 클래스는 JPA가 관리

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

- JPA 스펙상 파라미터가 없는 public 또는 protected 기본 생성자 필수

- 기본 생성자 필수

- final 클래스, enum, interface, inner 클래스에는 사용 불가능

- DB에 저장하고 싶은 필드는 final 사용 불가

 

3. @Table

@Entity
@Table(name="테이블명")
public class Member{

}

- name 속성 : 매핑할 테이블

이름

- catalog : 데이터베이스 catalog 매핑

- schema : 데이터베이스 schema 매핑

- uniqueConstraints : DDL 생성 시에 유니크 제약 조건 생성

 

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

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

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

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

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

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

 

속성

- hibernate.hbm2ddl.auto 옵션

주의점

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

- 개발 초기 단계에는 create 또는 update

- 테스트 서버에는 update 또는 validate

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

 

DDL 생성 기능

- 제약조건 추가: 회원 이름은 필수, 10자 초과 X

- @Column(unique=true, length=10)

- 유니크 제약조건 추가

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

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

-  @Table(name=”TBL”) 같은 경우는 insert,update 쿼리에 영향을 주는데 제약 조건같은 것은 실행에 영향을 주지 않고 단순히 DDL을 생성하는데만 영향을 준다.

 

5. @Column

- unique는 잘 안씀

- unique 기능은 @Table의 uniqueConstrains에서 사용(Unique Key에 이름을 줄 수 있기 때문)

 

6. @Enumerated

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

- 주의! ORDINAL 사용 금지

// 기본값 ORDINAL
EnumTypes.ORDINAL : enum 순서를 DB에 저장
EnumTypes.STRING : enum 이름을 DB에 저장

 

7. @Temporal

- 날짜 타입을 매핑할 때 사용

 

8. @Lob

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

- @Lob에는 지정할 수 있는 속성이 없다.

- 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑

- CLOB: String, char[], java.sql.CLOB

- BLOB: byte[], java.sql.BLOB

 

9. @Transient

- 필드 매핑 X

- 데이터베이스에 저장 X, 조회 X

- 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용

@Transient
private Integer temp;

 

10. 기본 키 매핑 방법

- 직접 할당: @Id만 사용

- 자동 생성(@GeneratedValue)

- IDENTITY: 데이터베이스에 위임, MYSQL

- SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE(@SequenceGenerator 필요)

- TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용(@TableGenerator 필요)

- AUTO: 방언에 따라 자동 지정, 기본값

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)

 

11.IDENTITY 전략 - 특징

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

- 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용

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

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

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

 

12. SEQUENCE 전략 - 특징

- 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트

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

 

SEQUENCE 전략 - 매핑

@Entity
@SequenceGenerator( // SEQUENCE 전략 사용시 GENERATOR을 먼저 만들고 사용 시 식별자로 지정해서 사용한다.
  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;

 

13. TABLE 전략

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

- 장점: 모든 데이터베이스에 적용 가능

- 단점: 성능

 

TABLE 전략 - 매핑

create table MY_SEQUENCES (
	sequence_name varchar(255) not null,
    next_val bigint,
    primary key (sequence_name)
) 


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

 

14. 권장하는 식별자 전략

- 기본 키 제약 조건: null 아님, 유일, 변하면 안된다.

- 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다.

- 대리키(대체키)를 사용하자.

- 예를 들어 주민등록번호도 기본 키로 적절하지 않다.

- 권장: Long형 + 대체키 + 키 생성전략 사용

 

SEQUENCE - @SequenceGenerator

- 주의: allocationSize 기본값 = 50