[JPA] 4.엔티티 매핑
들어가기 전에)
JPA는 다양한 매핑 어노테이션을 지원하는데 크게 4가지로 분류
-객체와 테이블 매핑: @Entity, @Table
-기본 키 매핑 : @Id
-필드와 컬럼 매핑:@Column
-연관관계 매핑:@ManyToOne, @JoinColumn
먼저 객체와 테이블 매핑 어노테이션부터 알아보자.
4.1 @Entity
@Entity가 붙은 클래스는 JPA가 관리하는 것으로, 엔티티라 부른다.
-@Entity 속성 정리
| 속성 | 기능 | 기본값 |
| name | JPA에서 사용할 엔티티 이름을 지정한다. 보통 기본값인 클래스 이름을 사용한다. 만약 다른 패키지에 이름이 같은 엔티티 클래스가 있다면 이름을 지정해서 충돌하지 않도록 해야 한다. | 설정하지 않으면 클래스 이름을 그대로 사용(예: Member) |
-주의사항
- 기본 생성자는 필수다(파라미터가 없는 public 또는 protected 생성자)
- final 클래스,enum,interface,inner 클래스에는 사용할 수 없다.
- 저장할 필드에 final을 사용하면 안 된다.
4.2 @Table
@Table을 엔티티와 매핑할 테이블을 지정한다.
생략하면 매핑한 엔티티 이름을 테이블 이름으로 사용한다.
-속성 정리
| 속성 | 기능 | 기본값 |
| name | 매핑할 테이블 이름 | 엔티티 이름을 사용한다. |
| catalog | catalog 기능이 있는 데이터베이스에서 catalog를 매핑한다. | |
| schema | schema 기능이 있는 데이터베이스에서 schema를 매핑한다. | |
| uniqueConstraints | DDL 생성 시에 유니크 제약조건을 만든다. 2개 이상의 복합 유니크 제약조건도 만들 수 있다. 참고로 이 기능은 스키마 자동 생성 기능을 사용해서 DDL을 만들 때만 사용된다. |
4.7 필드와 컬럼 매핑: 레퍼런스
-필드와 컬럼 매핑 분류
| 분류 | 매핑 어노테이션 | 설명 |
| 필드와 컬럼 매핑 | @Column | 컬럼을 매핑한다. |
| @Enumerated | 자바의 enum 타입을 매핑한다. | |
| @Temporal | 날짜 타입을 매핑한다. | |
| @Lob | BLOB,CLOB 타입을 매핑한다. | |
| @Transient | 특정 필드를 데이터베이스에 매핑하지 않는다. | |
| 기타 | @Access | JPA가 엔티티에 접근하는 방식을 지정한다. |
4.7.1 @Column
@Column은 객체 필드를 테이블 컬럼에 매핑한다. 속성 중에 name, nullable이 주로 사용되고 나머지는 잘 사용되지 않는 편이다.
-속성 정리
| 속성 | 기능 | 기본값 |
| name | 필드와 매핑할 테이블의 컬럼 이름 | 객체의 필드 이름 |
| insertable (거의 사용하지 않음) |
엔티티 저장 시 이 필드도 같이 저장한다. false로 설정하면 이 필드는 데이터베이스에 저장하지 않는다. false옵션은 읽기 전용일 때 사용한다. | true |
| updatable (거의 사용하지 않음) |
엔티티 수정 시 이 필드도 같이 수정한다. false로 설정하면 데이터베이스에 수정하지 않는다. false옵션은 읽기 전용일 때 사용한다. | true |
| nullable(DDL) | null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙은다. | true |
| unique(DDL) | @Table의 uniqueConstraintes와 같이만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용한다. 만약 두 컬럼 이상을 사용해서 유니크 제약조건을 사용하려면 클래스 레벨에서 @Table.uniqueConstraints를 사용해야 한다. | |
| columnDefinition(DDL) | 데이터베이스 컬럼 정보를 직접 줄 수 있다. | 필드의 자바 타입과 방언 정보를 사용해서 적절한 컬럼 타입을 생성한다. |
| length(DDL) | 문자 길이 제약조건, Sting 타입에만 사용한다. | 255 |
4.7.2 @Enumerated
-속성 정리
| 속성 | 기능 | 기본값 |
| value | EnumType.ORDINAL : enum 순서를 데이터베이스에 저장 EnumType.STRING : enum 이름을 데이터베이스에 저장 |
EnumType.ORDINAL |
-사용 예
//enum 클래스
enum RoleType{
ADMIN, USER
}
//enum 이름으로 매핑
@Enumerated(EnumType.STRING)
private RoleType roleType;
//사용
member.setRoleType(RoleType.ADMIN); //DB에 문자 ADMIN으로 저장됨- EnumType.ORDINAL은 enum에 정의된 순서대로 ADMIN은 0, USER는 1 값이 데이터베이스에 저장된다.
-장점 : 데이터베이스에 저장되는 데이터 크기가 작다.
-단점 : 이미 저장된 enum의 순서를 변경할 수 없다.
- EnumType.STRING은 enum 이름 그대로 ADMIN은 'ADMIN', USER는 'USER'라는 문자로 데이터베이스에 저장된다.
-장점 : 저장된 enum의 순서가 바뀌거나 enum이 추가되어도 안전하다
-단점 : 데이터베이스에 저장되는 데이터크기가 ORDINAL에 비해서 크다
->EnumType.STRING을 권장한다.
4.7.3 @Temporal
날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용한다.
-속성 정리
| 속성 | 기능 | 기본값 |
| value | TemporalType.DATE : 날짜, 데이터베이스 date 타입과 매핑 (예: 2013-10-11) TemporalType.TIME : 시간, 데이터베이스 time 타입과 매핑(예: 11:11:11) TemporalType.TIMESTAMP : 날짜와 시간,데이터베이스 timestamp 타입과 매핑 (예 : 2013-10-11 11:11:11) |
TemporalType은 필수로 지정해야 한다. |
@Temporal을 생략하면 자바의 Date와 가장 유사한 timestamp로 정의된다.
데이터베이스 방언에 따라 생성되는 DDL은 다음과 같다
datetime : MYSQL
timestamp : H2, 오라클, PostgreSQL