[JPA] 엔티티 매핑 - 객체와 테이블 매핑, 필드와 컬럼 매핑

엔티티 매핑

1) 객체와 테이블 매핑 : @Entity, @Table

2) 필드와 컬럼 매핑 : @Column

3) 기본 키 매핑 : @Id

4) 연관관계 매핑 : @ManyToOne, @JoinColumn

 

객체와 테이블 매핑

 

@Entity

@Entity가 붙은 클래스는 JPA가 관리하고, 엔티티라고 부른다.

JPA를 사용해서 테이블과 매핑할 클래스는 @Entity가 필수다.

 

[주의할 점]

1) 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)

2) final 클래스, enum, interface, inuuer 클래스를 사용해선 안된다.

3) 저장할 필드에 final 키워드를 사용해선 안된다.

 

속성 - name

JPA에서 사용할 엔티티 이름을 지정한다. 기본값은 클래스 이름을 그대로 사용한다.

같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

 

@Table

엔티티와 매핑할 테이블을 지정한다.

 

속성 - name

매핑할 테이블 이름이고, 기본값으로 엔티티 이름을 사용한다.

 

속성 - catalog

데이터베이스 catalog 매핑

 

속성 - schema

데이터베이스 schema 매핑

 

속성 - uniqueConstraints (DDL)

DDL 생성 시에 유니크 제약 조건 생성

 

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

DDL을 애플리케이션 실행 시점에서 자동 생성테이블 중심에서 객체 중심으로..

데이터베이스 방언을 활용해서 데이트베이스에 맞는 적절한 DDL을 생성한다.

(방언 : mysql과 oracle의 limit, rownum)

이렇게 생성된 DDL은 개발장비에서만 사용한다.

생성된 DDL은 운영서버에서는 사용하지 않거나, 적절히 다듬은 후 사용한다.

 

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

hibernate.hbm2ddl.auto (auto 옵션)

pom.xml

<property name="hibernate.hbm2ddl.auto" value="create" />

 

옵션 - create

기존테이블 삭제 후 다시 생성 (DROP + CREATE)

 

옵션 - create-drop

create와 같은 방식이지만, 종료시점에 테이블을 DROP 한다.

 

옵션 - update

변경분만 반영한다.(운영 DB에서는 절대로 사용해선 안된다.)

 

옵션 - validate

엔티티와 테이블이 정상 매핑되었는지만 확인한다.

 

옵션 - none

위 4가지의 값만 아니면, 다 아무 의미 없는 값이지만, 명시적으로 none이라고 표현한다.

 

데이터베이스 스키마 자동 생성 - 주의할 점

운영 장비에서는 절대로 create, create-drop, update를 사용하지 않는다.

개발 초기 단계 : create, update

테스트 서버 : update, validate

스테이징, 운영서버 : validate, none

 

DDL 생성 기능

제약조건 추가 : 회원 이름은 필수이고 10자 이상 초과하지 않는다. 

@Column(nullable = false, length = 10)

 

유니크 제약 조건 추가

@Table(uniqueConstraints = {@UniqueConstraint(name = "NAME_AGE_UNIQUE", columnNames = {"NAME","AGE"})})

DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향을 주지 않는다.

 

필드와 컬럼 매핑

예) 요구사항 

1) 회원은 일반 회원과 관리자로 구분

2) 회원 가입일과 수정일이 있어야 함.

3) 회원을 설명할 수 있는 필드가 있어야 함. 해당 필드는 길이 제한이 없음.

 

import javax.persistence.*;
import java.util.Date;

@Entity
public class RemindMember {

    @Id
    private Long id;
    @Column(name = "name")
    private String username;
    private Integer age;
    @Enumerated(EnumType.STRING)
    private RoleType roleType;
    @Temporal(TemporalType.TIMESTAMP)
    private Date createDate;
    @Temporal(TemporalType.TIMESTAMP)
    private Date lastModifiedDate;
    @Lob
    private String description;
    
}

 

요구사항 1) 은 enum RoleType으로 Member와 ADMIN를 구분한다. @Enumerated을 사용하며, 속성 값 EnumType.STRING을 사용한다. 여기서, EnumType.String 옵션을 사용해야 한다. EnumType.ORDINAL을 사용하게 되면, enum 타입이 새로 추가되었을 때, 순서가 변경되어 데이터에 치명적인 결함을 줄 수 있다.

 

요구사항 2)는 Date 형으로 createDate와 lastModifiedDate를 선언하였으며, 어노테이션은 @Temporal을 사용한다. @Temporal는 날짜 타입을 매핑할 때 사용한다.

 

요구사항 3) 은 @Lob 어노테이션을 사용하며, 해당 어노테이션은 BLOB, CLOB을 매핑한다.

 

매핑 어노테이션 정리

@Column : DB의 테이블과 컬럼을 매핑한다.

@Temporal : 날짜 타입을 매핑한다.

@Enumerated : enum 타입을 매핑한다.

@Lob : BLOB, CLOB을 매핑한다.

@Transient : 특정 필드를 컬럼에 매핑하지 않는다. (매핑 무시)

 

@Column의 속성

속성 - name 

필드와 매핑할 테이블의 컬럼이름, 기본 값으로 객체의 필드 이름을 사용한다.

 

속성 - insertable, updatable

등록 변경, 가능 여부, 기본값 : TURE

 

속성 - nullable(DDL)

null의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.

 

속성 - columnDefinition(DDL)

데이터베이스 컬럼 정보를 직접 줄 수 있다. ex) varchar(1000) default 'EMPTY'

필드의 자바 타입과 방언 정보를 사용해 기본값으로 설정한다.

 

속성 - length(DDL)

문자 길이 제약조건, String 타입에만 사용한다. 기본값은 255이다.

 

속성 - precision, scale(DDL)

BigDecimal 타입에서 사용한다. BigInteger도 사용가능

precision은 소수점을 포함한 전체 자릿수를, scale은 소수의 자릿수다.

참고로 dobule과 float 타입에는 적용되지 않는다.

아주 큰 숫자나 정밀한 소수를 다루어야 할 때 사용한다.

기본값으로 precision = 19, scale = 2

 

@Enumerated

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

주의할 점은 앞서 언급했듯이, ORDINAL을 사용하지 않는다.

 

속성 - value

EnumType.ORDINAL : enum 순서를 데이터베이스에 저장한다.

EnumTpye.STRING : enum 이름을 데이터베이스에 저장한다.

기본값으로 EnumType.ORDINAL을 사용하므로 STRING을 사용해야 한다.

 

@Temporal

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

참고로, LocalDate, LocalDateTime을 사용할 때는 생략이 가능하다. (최신 하이버네이트에서 지원)

 

속성 - value 

TemporalType.DATE : 날짜, 데이터베이스 date 타입과 매핑 ex) 2023-02-26

TemporalType.TIME : 시간, 데이터베이스 time  타입과 매핑 ex) 00:12:45

TemporalTpye.TIMESTAMP : 날짜와 시간, 데이터베이스 timestamp 타입과 매핑 ex) 2023-02-26 0:12:45

 

@LOB

데이터베이스 BLOB, CLOB 타입과 매핑

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

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

CLOB : String, char [], java.sql.CLOB

BLOB : byte [], java.sql.BLOB

 

@Transient

필드를 매핑하지 않을 때 사용한다.

데이터베이스에 저장하지 않고, 조회하지도 않는다.

주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용한다.