[JPA-Basic][4] 엔티티 매핑

kiteB·2021년 10월 11일
COLUMNDDLJPASpringTILTableentity엔티티 매핑
0

JPA

목록 보기
4/28
post-thumbnail

[ 엔티티 매핑 ]

JPA가 지원하는 대표적인 매핑 어노테이션

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

[ 객체와 테이블 매핑 ]

1. @Entity

@Entity가 붙은 클래스는 JPA가 관리하며, 이를 엔티티라고 한다.

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

주의사항

  • 기본 생성자 필수 (파라미터가 없는 public 또는 protected 생성자)
  • final 클래스, enum, interface, inner 클래스는 사용 ❌
    → 해당 클래스는 @Entity를 붙여서 DB Table과 매핑할 수 없다.
  • DB에 저장할 필드에 final 사용 ❌

속성 - name

@Entity(name = "Member")
public class Member { ... }
  • JPA에서 사용할 엔티티 이름을 지정한다.
  • 기본값: 클래스 이름을 그대로 사용한다. - Ex) Member
  • 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

2. @Table

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

  • 생략하면 매핑한 엔티티 이름을 테이블 이름으로 사용한다.
@Entity
@Table(name = "MBR")
public class Member { }


→ MBR 테이블을 사용하는 쿼리가 나간다.

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

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

1. hibernate.hbm2ddl.auto 속성

운영 DB에서는 절대 create, create-drop, update를 사용하면 안 된다.

  • 개발 초기 단계: create, update
  • 테스트 서버: update, validate
  • 스테이징과 운영 서버는 validate, none

2. 실습

  • persistence.xml 파일의 다음 코드 주석을 해제하고,
<property name="hibernate.hbm2ddl.auto" value="create" />

실행하면

이렇게 뜬다! 데이터가 다 날라간 것을 확인할 수 있다.

지난번에는 직접 H2 데이터베이스에 들어가서 create 코드를 넣었어야 했는데 지금은 알아서 만들어주었다.


3. DDL 생성 기능

  • 제약 조건 추가: 회원 이름은 필수, 10자 초과
    • @Column(nullable = false, length=10)
  • 유니크 제약 조건 추가
    • @Table(uniqueConstraints = {@UniqueConstraint(name = "NAME_AGE_UNIQUE", columnNames = {"NAME", "AGE"} )})

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

[ 필드와 컬럼 매핑 ]

📌 요구사항 추가

  • 회원은 일반 회원과 관리자로 구분해야 한다.
  • 회원 가입일과 수정일이 있어야 한다.
  • 회원을 설명할 수 있는 필드가 있어야 한다. 이 필드는 길이 제한이 없다.
package hellojpa; 

import javax.persistence.*; 
import java.time.LocalDate; 
import java.time.LocalDateTime; 
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;

매핑 어노테이션 정리

hibernate.hbm2ddl.auto

1. @Column ⭐

객체 필드를 테이블 컬럼에 매핑한다.

  • unique: @Column보다 @Table에서 사용하는 것을 권장한다.

2. @Enumerated

자바 enum 타입을 매핑할 때 사용한다.(DB에는 enum 타입이 없기 때문이다!)

  • 주의! ORDINAL 사용 ❌
    → enum 타입이 추가/변경/삭제되어 순서가 달라질 경우 문제가 발생한다!

3. @Temporal

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

  • LocalDate(년월), LocalDateTime(년월일)을 사용할 때는 생략 가능(최신 하이버네이트 지원)
  • @Temporal을 생략하면 timestamp로 정의된다.

4. @Lob

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

  • @Lob에는 지정할 수 있는 속성이 없다.
  • 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑
    • CLOB: String, char[], java.sql.CLOB
    • BLOB: byte[], java.sql.BLOB

5. @Transient

필드 매핑이 안되게 하는 어노테이션

  • 데이터베이스에 저장 ❌, 조회 ❌
  • 주로 메모리 상에서만 임시로 어떤 값을 보관하고 싶을 때 사용
@Transient
private Integer temp;

[ 기본 키 매핑 ]

1. 기본 키 매핑 어노테이션

  • @Id
  • @GeneratedValue
@Id @GeneratedValue(strategy = GenerationType.AUTO)
private Long id;

2. 기본 키 매핑 방법

  • 직접 할당: @Id만 사용
    • 기본 키를 애플리케이션에서 직접 할당한다.
  • 자동 생성(@GeneratedValue): 대리 키 사용 방식
    • IDENTITY: 데이터베이스에 위임, MYSQL
    • SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE
      • @SequenceGenerator 필요
    • TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
      • @TableGenerator 필요
    • AUTO: 방언에 따라 자동 지정, 기본값

2-1. IDENTITY 전략

기본 키 생성을 데이터베이스에 위임한다.

  • 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용한다.
    • Ex) 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;

2-2. SEQUENCE 전략

데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트

  • 오라클, PostgreSQL, DB2, H2 데이터베이스에서 사용
  • em.persist()를 호출할 때 먼저 데이터베이스 시퀀스를 사용해서 식별자를 조회한다.
    • 조회한 식별자를 엔티티에 할당한 후에 엔티티를 영속성 컨텍스트에 저장한다.
    • 이후 트랜잭션을 커밋해서 플러시가 일어나면 엔티티를 데이터베이스에 저장한다.
    • vs IDENTITY : 먼저 엔티티를 데이터베이스에 저장한 후에 식별자를 조회해서 엔티티의 식별자에 할당한다.

매핑

@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;

@SequenceGenerator

  • 테이블마다 시퀀스를 따로 관리하고 싶을 때 사용한다.
  • 주의: allocationSize 기본값 = 50

2-3. TABLE 전략

키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략

  • 모든 데이터베이스에 적용이 가능하지만, 성능이 떨어진다.

매핑

  • 테이블 생성
create table MY_SEQUENCES ( 
    sequence_name varchar(255) not null, 
    next_val bigint, 
    primary key ( sequence_name ) 
)
  • Member.java 수정
@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;

@TableGenerator

SEQUENCE와 마찬가지로 initialValue와 allocationSize가 있다.


3. 권장하는 식별자 전략

  • 기본 키 제약 조건: null 아님 (NOT NULL), 유일 (UNIQUE), 변하면 안된다.
    • 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대체키)를 사용하자!
  • 권장: Long형 + 대체키 + 키 생성전략 사용!
profile
kiteB
🚧 https://coji.tistory.com/ 🏠
이전 포스트

[JPA-Basic][3] 영속성 관리 - 내부 동작 방식

다음 포스트

[JPA-Basic][5] 연관관계 매핑 기초

0개의 댓글