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

JPA/자바 ORM 표준 JPA 프로그래밍

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

c0mmedes 2023. 7. 13. 23:23

1. 객체와 테이블 매핑

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

@Entity

@Entity가 붙은 클래스는 JPA가 관리
JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수
기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
final, enum, interface, inner 클래스 사용X

@Entity
@Table(name = "MBR")// MBR이라는 테이블과 매핑 -> INSERT INTO MBR ~public class Member {

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

DDL(CREATE, ALTER, DROP)을 애플리케이션 실행 시점에 자동 생성
테이블 중심 -> 객체 중심
데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성
이렇게 생성된 DDL은 개발 장비에서만 사용
생성된 DDL은 운영서버에서는 사용하지 않거나, 적절히 다듬은 후 사용

속성

persistence.xml

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

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

주의

운영 장비에는 절대 create, create-drop, update 사용 x
개발 초기 단계는 create 또는 update
테스트 서버는 update 또는 validate (여러명이서 개발하는 환경)
스테이징과 운영 서버는 validate 또는 none

DDL 생성 기능

Member.java

 @Column(unique = true, length = 10)
    private String name;

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

3. 필드와 컬럼 매핑

필드와 컬럼 매핑: @Column

매핑 어노테이션 정리

hibernate.hbm2ddl.auto

@Column - 컬럼 매핑
- name - 필드와 매핑할 테이블의 컬럼 이름 (기본값 - 객체의 필드 이름)
- insertable, updatable - 등록, 변경 가능 여부 (기본값 - TRUE)
- nullable(DDL) - null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.
- unique(DDL) - @Table uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용한다. (키값이 이상하게 부여돼서 자주 사용하지 않고 @Table 속성에서 주로 씀)
- columnDefinition(DDL) - 데이터베이스 컬럼 정보를 직접 줄 수 있다. ex) varchar(100) default ‘EMPTY'
- length(DDL) - 문자 길이 제약조건, String 타입에만 사용한다. (기본값 - 255)
- precision, scale(DDL) - BigDecimal 타입에서 사용한다(BigInteger도 사용할 수 있다). precision은 소수점을 포함한 전체 자 릿수를, scale은 소수의 자릿수다. 참고로 double, float 타입에는 적용되지 않는다. 아주 큰 숫자나 정밀한 소수를 다루어야 할 때만 사용한다. (기본값 - precision=19, scale=2)
@Temporal - 날짜 타입 매핑
- TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑 (예: 2013–10–11)
- TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑 (예: 11:11:11)
- TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이 스 timestamp 타입과 매핑(예: 2013–10–11 11:11:11)
- 참고: LocalDate, LocalDateTime을 사용할 때는 생략 가능(최신 하이버네이트 지원)
@Enumerated - enum 타입 매핑
- EnumType.ORDINAL(기본값): enum 순서를 데이터베이스에 저장
- EnumType.STRING: enum 이름을 데이터베이스에 저장
- ORDINAL 사용X → 순서로 갱신하기 때문에 새로운 값이 추가되면 그게 다시 0이돼서
@Lob - BLOB, CLOB 매핑
- @Lob에는 지정할 수 있는 속성이 없다.
- 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑 • CLOB: String, char[], java.sql.CLOB • BLOB: byte[], java.sql. BLOB
@Transient - 특정 필드를 컬럼에 매핑하지 않음(매핑 무시), DB에서는 사용하지 않게(메모리에만 사용할 수 있게)

4. 기본 키 매핑

기본 키 매핑
- 자동 생성 - @GeneratedValue
  - IDENTITY: 데이터베이스에 위임, MYSQL
    - 기본 키 생성을 데이터베이스에 위임
    - 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용 (예: MySQL의 AUTO_ INCREMENT)
    - JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL 실행
    - AUTO_ INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID 값을 알 수 있음
    - IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL 실행하고 DB에서 식별자를 조회
```
@Entity
public class Member {
 @Id
 @GeneratedValue(strategy = GenerationType.IDENTITY)
 private Long id;
```
  - SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE @SequenceGenerator 필요
    - 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트(예: 오라클 시퀀스)
    - 오라클, PostgreSQL, DB2, H2 데이터베이스에서 사용
```
@Entity
@SequenceGenerator(
 name = “MEMBER_SEQ_GENERATOR",
 sequenceName = “MEMBER_SEQ", //매핑할 데이터베이스 시퀀스 이름
 initialValue = 1, allocationSize = 1)
public class Member {
 @Id
 @GeneratedValue(strategy = GenerationType.SEQUENCE,
 generator = "MEMBER_SEQ_GENERATOR")
 private Long id;
```
  - TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
    - @TableGenerator 필요
    - 키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략
    - 장점: 모든 데이터베이스에 적용 가능
    - 단점: 성능
    - 비주류
```
@Entity
@TableGenerator(
 name = "MEMBER_SEQ_GENERATOR",
 table = "MY_SEQUENCES",
 pkColumnValue = “MEMBER_SEQ", allocationSize = 1)
public class Member {
 @Id
 @GeneratedValue(strategy = GenerationType.TABLE,
 generator = "MEMBER_SEQ_GENERATOR")
 private Long id;
```
```
create table MY_SEQUENCES (
 sequence_name varchar(255) not null,
 next_val bigint,
 primary key ( sequence_name )
)
```
  - AUTO: 방언에 따라 자동 지정, 기본값
- 직접 할당 - @Id
연관관계 매핑: @ManyToOne, @JoinColumn

권장하는 식별자 전략

기본 키 제약 조건: null 아님, 유일, 변하면 안된다.
미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대 체키)를 사용하자.
예를 들어 주민등록번호도 기본 키로 적절하지 않다.
권장: Long형 + 대체키 + 키 생성전략 사용

5. 실전 예제 -1. 요구사항 분석과 기본 매핑

요구사항 분석

회원은 상품을 주문할 수 있다.
주문 시 여러 종류의 상품을 선택할 수 있다.

기능 목록

회원 기능
- 회원등록
- 회원조회
상품 기능
- 상품등록
- 상품수정
- 상품조회
주문 기능
- 상품주문
- 주문내역조회
- 주문취소

도메인 모델 분석

회원과 주문의 관계: 회원은 여러 번 주문할 수 있다. (일대다)
주문과 상품의 관계: 주문할 때 여러 상품을 선택할 수 있다. 반대로 같은 상품도 여러 번 주문될 수 있다. 주문상품 이라는 모델을 만들어서 다대다 관계를 일다대, 다대일 관계로 풀어냄

테이블 설계

엔티티 설계와 매핑

데이터 중심 설계의 문제점

현재 방식은 객체 설계를 테이블 설계에 맞춘 방식
테이블의 외래키를 객체에 그대로 가져옴
객체 그래프 탐색이 불가능
참조가 없으므로 UML도 잘못됨

package jpabook.jpashop.domain;

import javax.persistence.*;
import java.time.LocalDateTime;

@Entity
@Table(name = "ORDERS") // db의 예약어가 order인 경우가 있어서
public class Order {

    @Id @GeneratedValue
    @Column(name = "ORDER_ID")
    private Long id;

    // 주문자명
    // 관계형DB를 객체에 만든 설계
    @Column(name = "MEMBER_ID")
    private Long memberId;

    // 이게 객체지향적인 코드
//    Private Member member
//    public Private getMember() {
//        return Member;
//    }

    private LocalDateTime orderDate;

    @Enumerated(EnumType.STRING)
    private OrderStatus status;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public Long getMemberId() {
        return memberId;
    }

    public void setMemberId(Long memberId) {
        this.memberId = memberId;
    }

    public LocalDateTime getOrderDate() {
        return orderDate;
    }

    public void setOrderDate(LocalDateTime orderDate) {
        this.orderDate = orderDate;
    }

    public OrderStatus getStatus() {
        return status;
    }

    public void setStatus(OrderStatus status) {
        this.status = status;
    }
}