엔티티 매핑 1(테이블, 컬럼, 키 매핑 전략)

엔티티 매핑

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

 

1. 객체와 테이블 매핑

@Entity

• @Entity가 붙은 클래스는 JPA가 관리, 엔티티라 함
• JPA를 사용해서 테이블과 매핑할 클래스
• 기본 생성자 필수(public 또는 protected 접근제한자)
• 가급적 name 속성은 따로 지정하지 않고 클래스명 그대로 사용한다.

 

@Table

• 엔티티와 매핑할 테이블 지정
• name 속성 : 테이블 이름
• catalog : 데이터베이스 catalog 매핑
• schema : 데이터베이스 schema 매핑
• uniqueConstraints : DDL 생성 시에 유니크 제약 조건 생성

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

• 참고 : https://kingpiggylab.tistory.com/327
• 애플리케이션 실행 시점에 자동 생섬
• 데이터베이스 방언을 활용해서 적절한 DDL 생성
• 생성된 DDL은 개발 장비에서만 사용
• 운영서버에서는 적절히 다듬은 후에 사용한다.

 

 

2. 필드와 컬럼 매핑

요구사항

1. 회원은 일반 회원과 관리자로 구분해야 한다.

2. 회원 가입일과 수정일이 있어야 한다.

3. 회원을 설명할 수 있는 필드가 있어야 한다. 이 필드는 길이 제한이 없다.

 

@Column

• 생략할 수 있는 어노테이션이며, 생략한다면 컬럼명이 스네이크 타입으로 변경되어 컬럼명이 된다. (userName -> user_name)
• name 속성 : 컬럼명 지정
• insertable, updatable 속성 : 등록, 변경 가능 여부
• nullable 속성(DDL) : Not Null 혹은 Null 지정 (디폴트 값은 Null)
• unique 속성(DDL) : @Table의 uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제 약조건을 걸 때 사용
• columnDefinition 속성(DDL) : 컬럼 정보 직접 주기(컬럼의 디폴트 값 설정)
• length 속성(DDL) : 문자 길이 제약조건, String 타입에만 사용 (생략가능, 디폴트 값 255)
• precision, scale : BingDecimal, BigInteger에서 사용한다. 아주 큰 숫자나 정밀한 소수
  • precision은 소수점을 포함한 전체 자릿수
  • scale은 소수의 자릿수

@Enumerated

• enum을 컬럼으로 저장하고 싶을 때 사용
• 디폴트 값은 enum의 순서
• ORDINAL는 사용하지 않기(enum 순서 변경 시 값의 의미가 완전 달라짐)

@Temporal

• Date, Time, TimeStamp 세 종류에 대해서 사용

LocalDateTime과 LocalDate

• LocalDateTime : 년, 월, 일 + 시간을 저장하고 싶을 때 사용하는 자료형 (Java 8 이상에서만 사용가능)
• LocalDate : 년, 월, 일만 저장하고 싶을 때 사용하는 자료형 (Java 8 이상에서만 사용가능)
• DATETIME(6)으로 매핑된다.

@Lob

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

@Transient

• 특정 필드를 컬럼에 매핑하지 않음(매핑 무시)
• 메모리 상으로만 임시로 어떤 값을 보관하고 싶을 때 사용

 

 

3. 기본 키 매핑

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

@Id

• @Id만 사용 -> 기본 키를 직접 할당할 때

@GeneratedValue

• @Id와 함께 사용해서 strategy 속성으로 기본 키 생성 전략 지정
• IDENTITY : 데이터베이스에 위임, MySql
• SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용, Oracle, @SequenceGenerator 필요
• TABLE : 키 생성용 테이블 사용, 모든 DB에서 사용, @TableGenerator 필요
• AUTO : 방언에 따라 자동 지정, 기본 값임

1. IDENTITY 전략

• 기본 키 생성을 데이터베이스에 위임
• 주로 MySql, PostgreSQL, SQL Server, DB2에서 사용
• JPA는 보통 트랜잭션을 커밋할 때 Insert를 날리는데, IDENTITY 속성은 디비에 Insert를 날려야 ID 값을 알 수 있으니 커밋할 때가 아닌 persist 시점에 즉시 Insert 쿼리를 날리고 ID를 얻음

 

2. SEQUENCE 전략

• 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트(Ex: 오라클 시퀀스)
• Oracle, PostgreSQL, DB2, H2 DB에서 사용
• name 속성 : 식별자 생성기 이름(필수)
• sequenceName 속성 : 데이터베이스에 등록되어 있는 시퀀스 이름
• initialValue 속성 : DDL 생성 시에만 사용, 시퀀스 DDL을 생성할 때 처음 시작하는 수 지정(디폴트 값 1)
• allocationSize 속성 : 시퀀스 한 번 호출에 증가하는 수(기본 값이 50이니 1씩 증가하려면 필수로 수정)
• catalog, schema 속성
• 커밋할 때 쿼리가 날아감

@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")
    pivate Long id;

	... 
}

 

3. TABLE 전략

• 키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략
• 모든 데이터베이스에 적용 가능하나 성능이 문제있음

 

4 AUTO 전략

• 방언에 따라 자동 지정, 기본 값임

 

 

권장하는 식별자 전략

• 기본 키 제약 조건 : Not null, 유일하기, 변하지 않기
• 미래까지 이런 조건을 만족하는 자연 키는 찾기 어려움(주민등록번호 같은거를 기본 키로 잡는 것)
• Long형 + 대체 키 + 키 생성전략을 사용하자!