Entity Mapping
객체와 테이블
@Entity
- @Entity가 붙은 클래스는 JPA가 관리
- JPA를 사용해서 테이블과 매핑할 클래스는 필수
- 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
- final 클래스, enum, interface, inner 클래스에는 사용 x
- 저장할 필드에 final 사용 x
@Entity 속성
- name : JPA에서 사용할 엔티티 이름을 지정. 기본값은 클래스 이름 그대로 사용
@Table
- 엔티티와 매핑할 테이블 지정
@Table 속성
- name : 매핑할 테이블 이름. 기본값은 엔티티 이름 사용
- catalog : 데이터베이스 catalog 매핑
- schema : 데이터베이스 schema 매핑
- uniqueConstraints(DDL) : DDL 생성 시에 유니키 제약 조건 생성
데이터 베이스 스키마 자동생성
- create : 기존테이블 삭제 후 다시 생성(DROP + CREATE)
- create-drop : create + 종료시점 table drop
- update : 변경분만 반영
- validate : entity와 table이 정상 매핑 되었는지만 확인
- none : 사용하지 않음
참고. 운영 장비에서는 create, create-drop, update 사용하면 안된다.
- 개발초기 : create or update
- 테스트 서버 : update or validate
- 운영 서버 : validate or none
필드와 컬럼
@Column
- 컬럼 매핑
@Column 속성
- name : 필드와 매핑할 테이블의 컬럼 이름(기본값 : 객체의 필드 이름)
- insertable, updatable : 등록, 변경 가능 여부(기본값 : TRUE)
- nullable(DDL) : null값의 허용 여부 설정. false하면 not null 제약조건 붙음
- unique(DDL) : @Table의 uniqueConstraints와 같이만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용(이름이 랜덤이라 사용x -> @table에서 걸수잇음)
- columnDefinition(DDL) : 데이터베이스 컬럼 정보를 직접 줄 수 있다. ex) varchar(100) default ‘EMPTY'
- length(DDL) : 문자 길이 제약 조건, String 타입에만 사용
- precision, scale(DDL) : BigDecimal, BigInteger 타입에서 사용. precision은 소수점을 포함한 전체 자릿수, scale은 소수의 자릿수. 참고로 double, float 타입에는 적용되지 않는다. 아주 큰 숫자나 정 밀한 소수를 다루어야 할 때만 사용한다.
@Temporal
- 날짜 타입 매핑
- TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑
- TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑
- TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이스 timestamp 타입과 매핑
- 참고: LocalDate, LocalDateTime을 사용할 때는 생략 가능
@Enumerated
- enum 타입 매핑(기본값 : EnumType.ORDINAL)
- 주의. ORDINAL 사용 x
- EnumType.ORDINAL: enum 순서를 데이터베이스에 저장
- EnumType.STRING: enum 이름을 데이터베이스에 저장
- 필수 STRING값으로 사용
@Lob
- 데이터베이스 BLOB, CLOB 타입과 매핑
- @Lob에는 지정할 수 있는 속성이 없다.
- 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑
- CLOB: String, char[], java.sql.CLOB
- BLOB: byte[], java.sql. BLOB
@Transient
- 특정 필드를 컬럼에 매핑하지 않음(매핑 무시)
- 데이터베이스에 저장X, 조회X
- 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용
기본키
직접 할당
- @Id만 사용
자동 생성
- @GeneratedValue
@GeneratedValue
- IDENTITY: 데이터베이스에 위임, MYSQL
- SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE
@SequenceGenerator 필요- AUTO: 방언에 따라 자동 지정, 기본값
- TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
@TableGenerator 필요(단점 : 성능)
@TableGenerator 속성
- name : 식별자 생성기 이름(기본값 : 필수)
- table : 키생성 테이블명(기본값 : hibernate_sequences)
- pkColumnName : 시퀀스 컬럼명(기본값 : sequence_name)
- valueColumnNa : 시퀀스 값 컬럼명(기본값 : next_val)
- pkColumnValue : 키로 사용할 값 이름((기본값 : 엔티티 이름)
- initialValue : 초기 값, 마지막으로 생성된 값이 기준이다.(기본값 : 0)
- allocationSize : 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨) (기본값 : 50)
- catalog, schema : 데이터베이스 catalog, schema 이름
- uniqueConstraint s(DDL) : 유니크 제약 조건을 지정할 수 있다.
권장하는 식별자 전략
- 기본 키 제약 조건: null 아님, 유일, 변하면 안된다.
- 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대체키)를 사용하자
- 예를 들어 주민등록번호도 기본 키로 적절하기 않다.
- 권장: Long형 + 대체키 + 키 생성전략 사용
참조 : 김영한님 JPA 강의
bedev