[JPA] Entity Mapping에 대하여 3 - 필드와 컬럼 매핑

해당 내용은 인프런의 '자바 ORM 표준 JPA 프로그래밍 - 기본편(김영한)'을 참고하여 작성하였습니다.

 

[Entity Mapping 설명 목차]

1. 객체와 테이블

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

3. 필드와 컬럼 매핑

4. 기본키 매핑

 

---

매핑 어노테이션

• @Column : 컬럼 매핑
• @Temporal : 날짜 타입 매핑
• @Enumerated : enum 타입 매핑
• @Lob : BLOB, CLOB 매핑
• @Transient : 특정 필드를 컬럼에 매핑하지 않음(매핑 제외) 

 

 

1. @Column

@Column(name = "name", insertable = true, updatable = true, nullable = false)
private String userName;

• name
  
  • 필드와 매핑할 테이블의 컬럼 이름
  • 기본값 : 객체의 필드 이름

• insertable, updatable
  • 등록, 변경 가능 여부
  • 기본값 : TRUE
• nullable(DDL)
  • null  값의 허용 여부 결정
  • false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.
• unique(DDL)
  • @Table의 uniqueConstrains와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용한다.
  • 하지만 제약조건의 이름이 랜덤으로 생성되기 때문에 잘 사용하지 않는다.
• columnDefinition(DDL)
  • 데이터베이스 컬럼 정보를 직접 줄 수 있다.
  • ex_varchar(100), default 'EMPTY'
  • 기본값 : 필드의 자바 타입과 방언 정보를 사용
• length(DDL)
  • 문자 길이 제약 조건
  • String 타입에만 사용한다.
  • 기본값 : 255
• precision, scale(DDL)
  • BigDeciaml 타입에서 사용(BigInteger도 사용 가능)
  • precision은 소수점을 포함한 전체 자릿수, scale은 소수의 자릿수
  • double, float 타입에는 적용되지 않음
  • 아주 큰 숫자나 정밀한 소수를 다뤄야할 때만 사용
  • 기본값 : precision = 19, scale = 2

 

2. @Enumerated

자바 enum 타입을 매핑할 때 사용한다.

주의할 점은 ORDINAL을 사용하지 않는 것을 권고한다.

자세한 이유는 코드를 보며 설명한다.

@Enumerated의 속성(value)

• EnumType.ORDINAL(기본값)
  : enum 순서를 데이터베이스에 저장
• EnumType.STRING
  : enum 이름을 데이터베이스에 저장

EnumType.ORDINAL을 사용하지 않는 이유

• ORDINAL로 지정할 경우, DB에는 integer 타입으로 데이터가 insert 됨
• Enum으로 user와 admin 2개의 값이 있다는 가정 하에
• member 객체를 각각 1개씩 삽입하면 user : 0, admin : 1로 DB에 데이터가 삽입됨
• 이때 기존 enum에 존재하지 않던 guest 객체가 삽입되면
• guest : 0, user : 1, admin : 2로 설정됨
• DB의 기존 데이터 0은 user를 가리키는데 현재는 guest를 가리킴 → 문제 발생

 

3. @Temporal

날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용한다.

최신 하이버네이트를 사용할 경우, LocalDate, LocalDateTime을 사용할 때 생략 가능하다.

@Temporal(TemporalType.TIMESTAMP)
private Date createdDate;

@Temporal(TemporalType.TIMESTAMP)
private Date lastModifiedDate;

private LocalDate testLocalDate; // date
private LocalDateTime testLocalDateTime; // timestamp

@Temporal의 속성(value)

• TemporalType.DATE
  : 날짜, 데이터베이스 date 타입과 매핑
• TemporalType.TIME
  : 시간, 데이터베이스 time 타입과 매핑
• TemporalType.TIMESTAMP
  : 날짜와 시간, 데이터베이스 timestamp 타입과 매핑

 

4. @Lob

데이터베이스의 BLOB, CLOB 타입과 데이터를 매핑한다.

@Lob에는 지정할 수 있는 속성이 없다.

대신 매핑하는 필드 타입이 문자이면 CLOB를, 나머지는 BLOB으로 매핑한다.

• CLOB
  : String, char[], java.sql.CLOB
• BLOB
  : byte[], java.sql.BLOB

 

5. Transient

• 필드와 컬럼을 매핑하는 어노테이션이 아니다.
• 때문에 DB에 저장, 조회를 하지 않는다.
• 주로 메모리 상에 임시로 어떤 값을 보관하고 싶을 때 사용한다.