// 이 속성을 추가하면 애플리케이션 실행 시점에 데이터베이스를 자동으로 생성한다.
<property name="hibernate.hbm2ddl.auto" value="create" />
// 이 속성을 true로 설정하면 콘솔에 실행되는 테이블 DDL을 출력할 수 있다.
<property name="hibernate.show_sql" value="true" />
옵션
설명
create
기존 테이블을 삭제하고 새로 생성한다. DROP + CREATE
create-drop
create 속성에 추가로 애플리케이션을 종료할 때 생성한 DDL를 제거한다. DROP + CREATE + DROP
update
데이터베이스 테이블과 엔티티 매핑정보를 비교해서 변경 사항만 수정한다.
validate
데이터베이스 테이블과 엔티티 매핑정보를 비교해서 차이가 있으면 경고를 남기고 애플리케이션을 실행하지 않는다.
none
hibernate.hbm2ddl.auto 속성 자체를 삭제하거나 유효하지 않은 옵션 값을 주면 된다.
참고
운영 서버에서 create, create-drop, update 처럼 DDL을 수정하는 옵션을 사용하면 안된다.
DDL을 자동 생성해주는 기능은 DDL를 생성할 때만 사용되고 JPA 실행 로직에는 영향을 주지 않다.
이 기능을 사용하면 애플리케이션 개발자가 엔티티만 보고도 손쉽게 다양한 제약 조건을 파악할 수 있는 장점이 있다.
기본키 맵핑
JPA가 제공하는 데이터베이스 기본 키 생성 전략
직접할당 : 기본 키를 애플리케이션에서 직접 할당한다.
자동 생성 : 대리 키 사용 방식
IDENTITY : 기본 키 생성을 데이터베이스에 위임
SEQUENCE : 시퀀스를 사용
TABLE : 키 생성 테이블 사용
<property name="hibernate.id.new_generator_mappings" value="true" />
// 키 생성 전략을 사용하려면 속성을 반드시 추가해야 한다.
// 하이버 네이트는 과거 버전과의 호환성을 유지하기 위해 기본값을 false로 두었다.
// 이 옵션을 true로 설정하면 키 생성 성능을 최적화하는 allocationSize 속성을 사용하는 방식이 달라진다.
★ allowcationSize 속성????
기본키 직접할당 전략
기본키를 직접 할당하려면 @Id로 매핑하면 된다.
@Id
@Column(name="id")
private String id입
@Id 적용 가능 자바 타입
- String
- java.util.Date
- java.sql.Date
- java.math.BigDecimal
- java.math.BigInteger
DB별 키 생성 전략
IDENTITY 전략 : IDENTITY는 기본키 생성을 데이터베이스에 위임하는 전략이다.
MySQL, PostgreSQL, DB2
SEQUENCE 전략
오라클, PostgreSQL, DB2, H2
기본키 자동생성 전략
@GenerationValue의 strategy 속성 값을 GenerationType.IDENTITY로 지정하면 된다.
엔티티가 영속상태가 되려면 식별자가 반드시 필요한데. IDENTITY 식별자 생성 전략은 엔티티가 데이터베이스에 저장해야 식별자를 구할 수 있으므로 em.persis()를 호출하는 즉시 INSERT SQL이 데이터베이스에 전달된다. 따라서 이 전략은 트랜잭션을 지원하는 쓰기 지연이 동작하지 않는다.
하이버네이트는 Statement.getGeneratedKeys()를 사용하여 데이터를 저장하면서 동시에 생생된 기본키 값을 얻어와 데이터 베이스와 한번만 통신 한다.
SEQUENCE 전략
@SequenceGenerator를 사용해서 시퀀스 생성기를 등록한 후 sequenceName 속성으로 시퀀스를 실제 데이터베이스의 스퀀스와 매핑한다. 다음으로 키 생성 전략을 GenerationType.SEQUENCE로 설정하고 generator 속성으로 등록한 시퀀스 생성기를 선택한다.
SEQUENCE 전략은 em.persis()를 호출할 때 먼저 데이터베이스 시퀀스를 사용해서 식별자를 조회한다.
조회한 식별자를 엔티티에 할당한 후에 엔티티를 영속성 컨텍스트에 저장한다.
이후 트랜잭션을 커밋해서 플러시가 일어나면 엔티티를 데이터베이스에 저장한다.
@SequenceGenerator
속성
기능
기본값
name
식별자 생성기 이름
필수
sequenceName
데이터베이스에 등록되어 있는 시퀀스 이름
hibernate_sequence
initialValue
DDL 생성 시에만 사용됨, 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정한다.
1
allocationSize
시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨)
50
catalog,sechema
데이터베이스 catalog, schema 이름
JPA 표준 명세에서는 sequenceName의 기본값을 JPA 구현체가 정의하도록 했다. 위의 설명한 기본값은 하이버네이트 기준이다.
SequenceGenerator.allocationSize의 기본값이 50인 것에 주이해야 하는데 JPA가 기본으로 생성하는 데이터베이스 시퀀스는 50이므로 시퀀스를 호출할 때마다 값이 50씩 증가한다. 기본값이 50인 이유는 최적화 때문인데 데이터베이스 시퀀스 값이 하나씩 증가하도록 설정되어 있으면 이 값을 반드시 1로 설정해야 한다.
SEQUENCE 전략은 데이터베이스 시퀀스를 통해 식별자를 조회하는 추가 작업이 필요한다. 따라서 데이터베이스와 2번 통신한다.
JPA는 시퀀스에 접근하는 횟수를 줄이기위해 최적화를 하는데 예를 들어 allocationsize 값이 50이면 시퀀스를 한 번에 50 증가 시킨 다음에 1~50까지는 메모리에서 식별자를 할당한다. 그리고 51이 되면 시퀀스 값을 100으로 증가시킨 다음 51~100까지 메모리에서 식별자를 할당한다.
참고로 hibernate.id.new_generator_mappings 속성을 true로 설정해야 지금까지 설명한 최적화 방법이 적용된다. 이 속성을 적용하지ㅏ 않으면 하이버네이트가 과거에 사용하던 방법으로 키 생성을 최적화한다.
과거에는 시퀀스 값을 하나씩 할당받고 애플리케이션에서 allocationsize만큼 사용했다.
TABLE 전략
TABLE 전략은 키 생성 전용 테이블을 하나 만들어 데이터베이스 시퀀스를 흉내내는 전략이다.
@TableGenerator를 사용해서 테이블 키 생성기를 등록한 후 GenerationType.TABLE을 선택했다. 그리고 @GeneratedValue.generator에 방금 만든 테이블 키 생성기를 지정하면 id 식별자 값은 테이블 키 생성기가 할당한다.
@TableGenerator
속성
기능
기본값
name
식별자 생성기 이름
필수
table
키생성 테이블명
hibernate_sequence
pkColumnName
시퀀스 컬럼명
sequence_name
valueColumnName
시퀀스 값 컬럼명
next_val
pkColumnValue
키로 사용할 값 이름
엔티티 이름
initialValue
초기 값, 마지막으로 생성된 값이 기준이다.
0
allocationSize
시퀀스 한 번 호출에 증가하는 수
50
catalog, schema
데이터베이스 catalog, schema 이름
uniqueConstraints(DDL)
유니크 제약 조건을 지정할 수 있다.
JPA 표준 명세에는 table, pkColumnName, valueColumnName의 기본값을 JPA 구현체가 정의하도록 했다. 위의 설명한 기본값은 하이버네이트 기준이다.
AUTO 전략
자동으로 데이터베이스가 키 생성 전략을 선택하여 사용(MySQL = IDENTITY, Oracle = SEQUENCE)
필드와 컬럼 매핑: 레퍼런스
분류
매핑 어노테이션
설명
필드와 컬럼 매핑
@Column
컬럼을 매핑한다.
필드와 컬럼 매핑
@Enumerated
자바의 enum 타입을 매핑한다.
필드와 컬럼 매핑
@Temporal
날짜 타입을 매핑한다.
필드와 컬럼 매핑
@Lob
BLOB, CLOB 타입을 매핑한다.
필드와 컬럼 매핑
@Transient
특정 필드를 데이터베이스에 매핑하지 않는다.
기타
Access
JPA가 엔티티에 접근하는 방식을 지정한다.
@Column
가장 많이 사용되고 기능도 많다.
name, nullable이 주로 사용되고 나머지의 사용빈도는 낮은 편이다.
속성
기능
기본값
name
필드와 매핑할 테이블의 컬럼 이름
객체의 필드 이름
insertable(거의 사용 X)
엔티티 저장시 이 필드도 같이 저장한다. false 옵션은 읽기 전용일 때 사용한다
true
updatable(거의 사용 X)
엔티티 수정 시 이 필드도 같이 수정한다. false 옵션은 읽기 전용일 때 사용한다
true
table(거의 사용 X)
하나의 엔티티를 두 개 이상의 테이블에 매핑할 때 사용한다. 지정한 필드를 다른 테이블에 매핑할 수 있다.
현재 클래스가 매핑된 테이블
nullable(DDL)
null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시 not null 제약 조건이 붙는다.
true
unique(DDL)
@Table의 uniqueConstraints와 같지만 한 컬럼에 간단한 유니크 제약조건을 걸 때 사용한다. 만약 두 컬럼 이상을 사용해서 유니크 제약조건을 사용하려면 클래스 레벨에서 @Table.uniqueConstraints를 사용해야 한다.
columDefinition(DDL)
데이터베이스 컬럼 정보를 직접 줄 수 있다.
필드의 자바 타입과 방언 정보를 사용해 적절한 컬럼 타입을 생성한다.
length(DDL)
문자 길이 제약조건, String 타입에만 사용한다.
255
precision,scale(DDL)
BigDecimal 타입에서 사용한다.(BigInteger도 사용할 수 있다). pecision은 소수점을 포함한 전체 자릿수를, scale은 소수의 자릿수다. 참고로 double, float 타입에는 적용되지 않는다. 아주 큰 숫자나 정밀한 소수를 다루어야 할 때만 사용한다.
precision=19, scale=2
@Enumerated
자바의 enum 타입을 매핑할 때 사용한다.
속성
기능
기본값
value
*EnumType.ORDINAL: enum 순서를 데이터베이스에 저장
EnumType.ORDINAL
value
*EnumType.STRING: enum 이름을 데이터베이스에 저장
EnumType.ORDINAL
EnumType.ORDINAL은 정의된 순서대로 값을 데이터 베이스에 저장(예: Admin는 0, User는 1)
장점: 데이터베이스에 저장되는 데이터 크기가 작다.
단점: 이미 저장된 enum 순서 변경 불가
EnumType.STRING은 이름 그대로 데이터 베이스에 저장(예: Admin는 Admin, User는 User)
장점: 저장된 enum의 순서가 바뀌거나 추가되어도 안전
단점: 데이터베이스에 저장되는 데이터 크기가 ORDINAL에 비해서 크다.
기본값은 ORDINAL은 주의해서 사용해야한다. STRING을 권장한다.
@Temporal
날짜 타입을 매핑할 때 사용한다.(Date, Calendar)
속성
기능
기본값
value
TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑
필수로 지정
value
TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑
필수로 지정
value
TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이스 timestamp 타입과 매핑
필수로 지정
자바의 Date 타입에는 년월일 시분초가 있지만 데이터베이스에는 date(날짜), time(시간), timestamp(날짜와 시간)라는 세 가지 타입이 별도로 존재한다.
@Temporal을 생략하면 자바의 Date와 가장 유사한 timestamp로 정의한다.
datetime: MySQL
timestamp: H2, Oracle, PostgreSQL
@Lob
데이터베이스 BLOB, CLOB 타입과 매핑한다.
@Lob에는 지정할 수 있는 속성이 없다. 대신에 매핑하는 필드 타입이 문자면 CLOB으로 나머지는 BLOB으로 매핑한다.
@Transient
이 필드는 매핑하지 않는다. 따라서 데이터베이스에 저장하지 않고 조회하지도 않는다. 객체에 임시로 어떤 값을 보관하고 싶을 때 사용한다.
@Access
JPA가 엔티티 데이터에 접근하는 방식을 지정한다.
필드 접근: AccessType.FIELD로 지정한다. 필드에 직접 접근한다. 접근 권한이 private이어도 접근할 수 있다.
프로퍼티 접근: AccessType.PROPERTY로 지정한다. Getter를 사용한다.
설정하지 않으면 @ID의 위치를 기준으로 접근 방식이 설정된다.
@Entity
@Access(AccessType.FIELD)
public class Member{
@Id
private String id;
private String data1;
private String data2;
}
@Id가 필드에 있으므로 @Access(AccessType.FIELD)로 설정한 것과 같다. @Access 생략가능
@Entity
@Access(AccessType.PROPERTY)
public class Member{
private String id;
private String data1;
private String data2;
@Id
public String getId(){
return id;
}
@Column
public String getData1(){
return data1;
}
public String getData2(){
return data2;
}
}
@Id가 프로퍼티에 있으므로, @Access 생략가능
@Entity
public class Member{
@Id
private String id;
@Transient
private String firstName;
@Transient
private String lastName;
@Access(AccessType.PROPERTY)
public String getFullName(){
return firstName + lastName;
}
@Id가 필드에 있으므로 기본은 필드 접근 방식 사용, @getFullName()만 프로퍼티 접근방식을 사용한다.
결과적으로 회원 엔티티를 저장하면 회원 테이블의 FULLNAME 컬럼에 firstName + lastName 결과가 저장된다.
JPA 스터디
@Entity
@Entity
가 붙은 클래스는 JPA가 관리하는 것으로 엔티티라 부른다.@Table
@Table
은 엔티티와 매핑할 테이블을 지정한다.데이터베이스 스키마 자동 생성
참고
운영 서버에서 create, create-drop, update 처럼 DDL을 수정하는 옵션을 사용하면 안된다.
이름 매핑 전략 변경하기
DDL 생성 기능
기본키 맵핑
JPA가 제공하는 데이터베이스 기본 키 생성 전략
기본키 직접할당 전략
기본키를 직접 할당하려면
@Id
로 매핑하면 된다.DB별 키 생성 전략
기본키 자동생성 전략
@GenerationValue
의 strategy 속성 값을 GenerationType.IDENTITY로 지정하면 된다.SEQUENCE 전략
@SequenceGenerator
를 사용해서 시퀀스 생성기를 등록한 후 sequenceName 속성으로 시퀀스를 실제 데이터베이스의 스퀀스와 매핑한다. 다음으로 키 생성 전략을 GenerationType.SEQUENCE로 설정하고 generator 속성으로 등록한 시퀀스 생성기를 선택한다.@SequenceGenerator
TABLE 전략
TABLE 전략은 키 생성 전용 테이블을 하나 만들어 데이터베이스 시퀀스를 흉내내는 전략이다.
@TableGenerator
를 사용해서 테이블 키 생성기를 등록한 후 GenerationType.TABLE을 선택했다. 그리고@GeneratedValue.generator
에 방금 만든 테이블 키 생성기를 지정하면 id 식별자 값은 테이블 키 생성기가 할당한다.@TableGenerator
AUTO 전략
필드와 컬럼 매핑: 레퍼런스
@Column
@Enumerated
@Temporal
@Lob
@Transient
@Column
@Table
의 uniqueConstraints와 같지만 한 컬럼에 간단한 유니크 제약조건을 걸 때 사용한다. 만약 두 컬럼 이상을 사용해서 유니크 제약조건을 사용하려면 클래스 레벨에서 @Table.uniqueConstraints를 사용해야 한다.@Enumerated
EnumType.ORDINAL은 정의된 순서대로 값을 데이터 베이스에 저장(예: Admin는 0, User는 1)
EnumType.STRING은 이름 그대로 데이터 베이스에 저장(예: Admin는 Admin, User는 User)
기본값은 ORDINAL은 주의해서 사용해야한다. STRING을 권장한다.
@Temporal
@Lob
@Transient
@Access