[자바 ORM 표준 JPA 프로그래밍] 4. 엔티티 매핑

서요이·2022년 11월 7일

JPA Java ORM Spring boot

자바 ORM 표준 JPA 프로그래밍

목록 보기

4/9

4. 엔티티 매핑

객체와 테이블 매핑

객체와 테이블 매핑: @Entity, @Table
필드와 컬럼 매핑: @Column
기본 키 매핑: @ID
연관관계 매핑: @ManyToOne, @JoinColumn

@Entity

@Entity가 붙은 클래스는 JPA가 관리, 엔티티
주의
기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
final 클래스, enum, interface, inner 클래스 사용 X
저장할 필드에 final 사용 X
name 속성 - 가급적 기본값 사용

@Table

@Table은 엔티티와 매핑할 테이블 지정
name, catalog, schema, uniqueConstrains(DDL) 유니크 제약 조건

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

DDL(Data Definition Language)을 애플리케이션 실행 시점에 자동 생성
테이블 중심 → 객체 중심
데이터베이스 방언 활용
이렇게 생성된 DDL은 개발 장비에서만 사용 (운영 서버에서 사용 X)

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

옵션	설명
create	기존 테이블 삭제 후 다시 생성 (DROP + CREATE)
create-drop	create와 같으나 종료 시점에 테이블 DROP
update	변경분만 반영 (운영DB 사용 X) - 삭제 반영 X
validate	엔티티와 테이블이 정상 매핑되었는지만 확인
none	사용하지 않음

데이터베이스 방언 별로 달라짐 (varchar)

주의!!!
운영 장비에는 절대 create, create-drop, update 사용하면 XXX
개발 초기 단계 - create 또는 update
테스트 서버 - update 또는 validate
스테이징과 운영 서버 - validate 또는 none

DDL 생성 기능
DDL 자동 생성시에만 사용되고 JPA 실행 로직에는 영향 주지 않음

제약조건 추가
ex) @Column(nullable = false, length = 10)
유니크 제약조건 추가
ex) @Table(uniqueConstraints = (@UniqueConstraint(name = "NAME_AGE_UNIQUE", columnNames=("NAME", "AGE"))))

필드와 컬럼 매핑

package hellojpa;

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

@Entity
public class Member {

    @Id
    private Long id;

    @Column(name = "name")
    private String username;

    private Integer age;

    @Enumerated(EnumType.STRING)
    private RoleType roleType;

    @Temporal(TemporalType.TIMESTAMP)
    private Date createdDate;

    @Temporal(TemporalType.TIMESTAMP)
    private Date lastModifiedDate;

    @Lob
    private String description;

    public Member() {
    }

    // Getter, Setter...
}

@Column - 컬럼 매핑

name: 필드와 매핑할 테이블의 컬럼 이름
insertable, updatable: 등록, 변경 가능 여부
nullable(DDL): null 값 허용 여부
unique(DDL): 한 컬럼에 유니크 제약 조건
columnDefinition(DDL): 데이터베이스 컬럼 정보 직접 제공
length(DDL): 문자 길이 제약 조건(String)
precision, scale(DDL): precision - 소수점 포함 전체 자릿수, scale - 소수의 자릿수 (아주 큰 숫자나 정밀한 소수 다룰 때 사용)

@Enumerated - 자바 enum 타입을 매핑

EnumType.ORDINAL: enum 순서를 데이터베이스에 저장
EnumType.STRING: enum 이름을 데이터베이스에 저장

주의! ORDINAL 사용 X - 순서 변경되면 문제 생길 수 있음

@Temporal - 날짜 타입(java.util.Date, java.util.Calendar) 매핑

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

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

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

@Transient - 필드 매핑 X, 데이터베이스에 저장 X, 조회 X

기본 키 매핑

직접 할당: @Id

자동 생성: @GeneratedValue

IDENTITY: 데이터베이스에 위임, MySQL
```
@Entity
public class Member {
	@Id
	@GeneratedValue(strategy = GenerationType.IDENTITY)
	private Long id;
```
DB에 값이 들어가야 id 값을 알 수 있음
영속성 컨텍스트에서 관리하려면 id 값을 알아야 하기 때문에 IDENTITY 전략에서만 커밋 시점이 아닌 em.persist() 시점에 즉시 INSERT SQL을 실행

SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE

@Entity
@SequenceGenerator(
	name = "MEMBER_SEQ_GENERATOR",
	seqName = "MEMBER_SEQ",  // 매핑할 데이터베이스 시퀀스 이름
	initialValue = 1, allocationSize = 1)
public class Member {
	@Id
	@GeneratedValue(stratege = GenerationType.SEQUENCE, generator = "MEMBER_SEQ_GENERATOR")
	private Long id;

allocationSize 기본 값: 50
sequence 값 50개 미리 올려 두고 사용

TABLE: 키 생성 전용 테이블 사용, 모든 DB, 단점: 성능

@Entity
@TableGenerator(
	name = "MEMBER_SEQ_GENERATOR",
	table = "MY_SEQUENCES",
	pkColumnValue = "MEMBER_SEQ", allocationSize = 1)
public class Member {
	@Id
	@GeneratedValue(stratege = GenerationType.TABLE, generator = "MEMBER_SEQ_GENERATOR")
private Long id;