엔티티 매핑

엔티티 매핑 소개

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

객체와 테이블 매핑

@Entity

• @Entity 가 붙은 클래스는 JPA가 관리, 엔티티라 한다.
• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수

@Entity 속성 정리

속성 : name

• JPA에서 사용할 엔티티 이름을 지정한다
• 기본값: 클래스 이름을 그대로 사용(예: Member)
• 같은 클래스 이름이 없으면 가급적 기본값을 사용한다

@Table

• @Table은 에티티와 매핑할 테이블 지정

name 예시

@Entity
@Table(name = "MBR")
public class Member {
    ~~
}

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

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

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

hibernate.hbm2ddl.auto

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

데이터베이스 스키마 자동 생성 - 주의점!! (중요)

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

DDL 생성 기능

• 제약조건 추가: 회원 이름은 필수, 10자 초과X

@Entity
@Table(name = "MBR")
public class Member {
 
    @Column(nullable = false, length = 10)
    private String name;
}

• 유니크 제약조건 추가

@Entity
@Table(uniqueConstraints = {@UniqueConstraint( name = "NAME_AGE_UNIQUE",columnNames = {"NAME", "AGE"} )})
public class Member {
 
    @Column(nullable = false, length = 10)
    private String name;
}

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

필드와 컬럼 매핑

매핑 어노테이션 정리

hibernate.hbm2ddl.auto

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

@Entity
public class Member {
 
    @Id
    private Long id;
 
    @Column(name = "name")
    private String name;
 
    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;
 
    @Transient
    private String tmp; // DB 테이블과 연동 제외됨
 
    public Member() {
 
    }
}

@Column

name

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

테이블 필드명이 username이 아닌 name 으로 맵핑됨

insertable, updatable

@Column(insertable = false, updatable = false)
private String username;

username 필드에 대해서는 이제 insert와 update가 불가능하게 막힘

nullable(DDL)

@Column(nullable = true)
private String username;

username 필드는 null값 비허용됨

unique(DDL)

@Column(unique = true)
private String username;

username 필드는 이제 한 테이블내의 고유값만 들어갈 수 있음 중복값 불가

@Entity
@Table(uniqueConstranints = ~~~)
    public class Member {
}

columnDefinition(DDL)

@Column(columnDefinition = "varchar(100) default 'EMPTY'")
private String username;

테이블의 username 필드가 varchar(100) 으로 지정되고 default 값이 Empty로 지정된다

length(DDL)

@Column(length = 10)
private String username;

테이블의 username 필드가 varchar(10) 으로 지정된다

@Enumerated

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

@Temporal

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

java8 에서 나온 LocalDate, LocalDateTime을 사용할 때는 생략 가능(최신 하이버네이트 지원)

@Lob

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

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

@Transient

• 필드 매핑X
• 데이터베이스에 저장X, 조회X
• 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용

기본 키 매핑 방법

DB마다 다르다

• 직접 할당: @Id만 사용

• 자동 생성**(@GeneratedValue)**

• IDENTITY : 데이터베이스에 위임, MYSQL • SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용, ORACLE • @SequenceGenerator 필요 • TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용 • @TableGenerator 필요 • AUTO: 방언에 따라 자동 지정, 기본값

IDENTITY 전략 - 특징

• 기본 키 생성을 데이터베이스에 위임

• 주로 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 전략 - 특징

• 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트(예: 오라클 시퀀스)

• 오라클, 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;
}

SEQUENCE - @SequenceGenerator

속성

TABLE 전략

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

• 장점: 모든 데이터베이스에 적용 가능

• 단점: 성능

TABLE 전략 - 매핑

create table MY_SEQUENCES (
 sequence_name varchar(255) not null,
 next_val bigint,
 primary key ( sequence_name )

@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 - 속성

권장하는 식별자 전략

• 기본 키 제약 조건: null 아님, 유일, 변하면 안된다.

• 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대 체키)를 사용하자.

• 예를 들어 주민등록번호도 기본 키로 적절하기 않다.

• 권장: Long형 + 대체키 + 키 생성전략 사용

중요 내용!

IDENTITY 전략을 사용하면 예외 적으로 Commit 이전에 Insert 쿼리가 실행된다

왜? ID 값이 정해지려면 DB에 INSERT 를 해야 정해짐.

JPA에서 영속성 컨텍스트(1차 캐싱) 을 위해서는 ID값이 필수임, 근데 INSERT 안하면 ID 값이 없기 때문에 일단 INSERT 먼저 때림

그렇다면 Bulk Insert와 같이 한번에 여러 insert를 하고 싶지만, JPA를 사용하면 불가능하다.

영한님 왈 : Buffer에 모아놨다가 Insert하는게 그다지 메리트 있지 않음, 트랜잭션이 여러번 실행되면 문제되지만 하나의 트랜잭션에서 여러번의 insert 호출은 큰 차이 없음

SEQUENCE 전략을 사용하면 em.persist(entity) 를 하면 SEQUENCE 객체로 부터 다음 값을 가져온다

IDENTITY 와는 다르게 insert commit단계에서 실행되서 Buffer에 모아놨다가 Insert하는게 가능하다

em.persist(entity) 를 하면 SEQUENCE 객체로 부터 다음 값을 가져오는 쿼리를 날리는데 매번 그러면 성능이슈가 발생하는거 아닌가?

allocationSize 를 사용하면 한번에 50개의 값을 셋팅해놓고 memory에서 카운팅하는 방법을 사용할 수 있다 즉 매번 SEQUENCE 값을 확이하지 않고 50번마다 확인함