JPA(3)

엔티티 매핑

종류

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

객체와 테이블 매핑

• @Entity가 붙은 클래스는 JPA가 관리, 엔티티라 한다.
• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수
• 주의
  • 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
  • final 클래스, enum, interface, inner 클래스 사용X
  • 저장할 필드에 final 사용 X

@Entity 속성

• JPA에서 사용할 엔티티 이름을 지정한다.
• 기본값 : 클래스 이름을 그대로 사용(추천)
• 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

@Table

• 엔티티와 매핑할 테이블 지정

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

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

• DDL을 애플리케이션 실행 시점에 자동 생성
• 테이블 중심 -> 객체 중심
• 데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성
• 이렇게 생성된 DDL은 개발 장비에서만 사용
• 생성된 DDL은 운영서버에서는 사용하지 않거나, 적절히 다듬 은 후 사용

옵션 - ddl-auto에 적용

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

옵션 기능 주의

• 운영 장비에는 절대 create, create-drop, update 사용하면 안된다.(내용이 지워질 수 있기 때문)
• 개발 초기 단계는 create 또는 update
• 테스트 서버는 update 또는 validate
• 스테이징과 운영 서버는 validate 또는 none

필드와 컬럼 매핑

@Entity
@Getter
@Setter
public class Member {
    @Id
    private Long id; //기본키 매핑

    @Column(name = "name")
    private String username; //객체는 username을 쓰고싶지만 데이터베이스 컬럼명은 name을 쓸 때

    private Integer age;//int말고 다른 타입 사용가능

    @Enumerated(EnumType.STRING)
    private RoleType roleType; //enum타입을 쓰고싶을 때

    @Temporal(TemporalType.TIMESTAMP)
    private Date createdDate; //날짜 타입을 쓰고싶을 때

    @Temporal(TemporalType.TIMESTAMP)
    private Date lastModifiedDate;

    @Lob
    private String description; //varchar를 넘어서는 큰 컨텐츠를 넣고 싶을때 사용
    
    @Transient
    private int temp; //DB랑 매핑하고 싶지 않을 때
}

애노테이션	설명
@Column	컬럼 매핑
@Temporal	날짜 타입 매핑
@Enumerated	enum 타입 매핑
@Lob	BLOB, CLOB 매핑
@Transient	특정 필드를 컬럼에 매핑하지 않음(매핑 무시)

-> Transient는 필드 매핑, 데이터베이스에 저장, 조회 모두 안된다, 주로 메모리상에서만 이시로 보관하고 싶을 때 사용한다.

@Colum 속성들

@Enumerated 주의

ORDINAL 사용하지 않기!

속성	설명	기본값
value	EnumType.ORDINAL : enum 순서를 데이터베이스에 저장, EnumType.STRING : enum 이름을 저장	EnumType.ORDINAL

-> 만약 enum에 zero, one이 있을 때 ordinal로 설정하면 0, 1이 들어가지만 만약 속성을 two, zero, one으로 하면 two속성을 넣을시 앞에서 넣은 zero와 같이 0이 들어가게 되어 큰 문제가 생긴다.

기본 키 매핑

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

IDENTITY 전략

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

@Entity 
public class Member { 
 @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; 

-> 여기서 allocationSize의 기본값이 50인 이유는 성능 최적화를 위함이다. SEQUENCE 전략도 위와 마찬가지로 DB에 Entity를 저장해야만 Key를 알 수 있는데, 이는 매번 저장할 때마다 SQL을 보내야 한다. 때문에 성능 문제를 고려하여 JPA는 한 번에 Sequence를 DB로 부터 받아와서 Entity의 Key Field에 할당 가능한 Sequence를 메모리에 보관한다. initialValue가 1인 경우, allocationSize에 크기만큼 Sequence를 받아오고, DB Sequence에는 size만큼 증가시켜놓습니다. Size가 너무 큰 경우, 중간에 Sequence가 낭비될 수 있기 때문에 주로 50 혹은 100으로 정해서 사용합니다.

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; 

권장하는 식별자 전략

• 기본 키 제약 조건: null 아님, 유일, 변하면 안된다.
• 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대체키)를 사용하자.
• 예를 들어 주민등록번호도 기본 키로 적절하기 않다.(정책이 바뀌어 주민등록번호를 사용하지 못할 경우)

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

• 출처 : 김영한의 자바 ORM 표준 JPA 프로그래밍 - 기본편