[자바 ORM 표준 JPA 프로그래밍 - 기본편] 2. 엔티티 매핑

해당 카테고리는 김영한님의 인프런 강의 '자바 ORM 표준 JPA 프로그래밍 - 기본편'을 듣고 내용을 정리하기 위한 것으로 자세한 설명은 해당 강의를 통해 확인할 수 있습니다.

자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의

---

📝 객체와 테이블 매핑

엔티티 매핑의 종류

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

 

이번 장에서는 먼저 객체와 테이블 매핑, 필드와 컬럼 매핑, 기본 키 매핑에 대해서 알아보고자 한다.

 

📜 객체와 테이블 매핑

@Entity

• @Entity가 붙은 클래스는 JPA가 관리하며, 이를 엔티티라 한다.
• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity를 필수적으로 작성해야 한다.
• 주의
  • 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
  • final 클래스, enum, interface, inner 클래스 사용 X
  • 저장할 필드에 final 사용 X
• Entity 속성 정리
  • name: JPA에서 사용할 엔티티 이름을 지정한다.
  • 기본값: 클래스 이름을 그래도 사용(예: Member)
  • 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

 

@Table

• @Table은 엔티티와 매핑할 테이블을 지정할 때 사용한다.

---

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

JPA를 사용하면 DDL을 애플리케이션 실행 시점에 자동 생성할 수 있다.

• 이는 즉, 개발자가 테이블을 먼저 생성하고 객체를 구현할 필요 없이 객체만 먼저 구현해도 JPA가 알아서 테이블을 만들어준다는 것이다.(테이블 중심 -> 객체 중심)
• 이때 JPA는 데이터베이스 방언을 활용하여 데이터베이스에 맞는 적절한 DDL을 생성하게 된다.
• 다만 이렇게 생성된 DDL은 개발 장비에서만 사용하고, 운영 서버에서는 사용하지 않는 것이 좋다. 필요시에는 적절히 다듬은 후 사용하는 것을 권장한다.

 

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

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

 

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

• 운영 장비에는 절대 create, create-drop, update를 사용하면 안된다.
• 개발 초기 단계에는 create 또는 update
• 테스트 서버는 update 또는 validate
• 스테이징과 운영 서버는 validate 또는 none

 

📜 DDL 생성 기능

• 제약조건 추가: 회원 이름은 필수, 10자 초과 X
  • Column(nullable = true, length = 10)
• 유니크 제약조건 추가
  • Column(unique = true)

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

---

📝 필드와 컬럼 매핑

예시를 들기 위해 요구사항을 먼저 추가해보도록 하자.

 

요구사항 추가

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

package hellojpa;

@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;
    
	//Getter, Setter…
}

 

매핑 어노테이션 정리

• @Column: 컬럼 매핑
  • name: 필드와 매핑할 테이블의 컬럼 이름(기본값: 객체의 필드 이름)
  • insertable, updatable: 등록, 변경 가능 여부(기본값: True)
  • nullable: null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약 조건이 붙는다.
  • unique: 한 컬럼에 간단히 유니크 제약 조건을 걸 때 사용한다.
    • 참고로 unique 속성 보다는 @Table의 uniqueConstraints 속성을 주로 사용하는 편임
  • columnDefinition: 데이터베이스 컬럼 정보를 직접 줄 수 있다.
    • columnDefinition = "varchar(100) default 'EMPTY'"
  • length: 문자 길이 제약 조건, String 타입에만 사용(기본값: 255)
  • precision, scale: BigDecimal 타입에서 사용한다.(BigInteger도 사용할 수 있음) precision은 소수점을 포함한 전체 자릿 수를, scale은 소수의 자릿 수다.(기본값: precision = 19, scale = 2)
    • 참고로 double, float 타입에는 적용되지 않는다.
    • 아주 큰 숫자나 정밀한 소수를 다루어야 할 때만 사용한다.
• @Temporal: 날짜 타입 매핑
  • value
    • TemporalType.DATE: 날짜, 데이터베이스 data 타입과 매핑
    • TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑
    • TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이스 timestamp 타입과 매핑
  • 참고
    • LocalDate, LocalDateTime을 사용할 경우 생략 가능(최신 하이버네이트 지원)
    • private LocalDate localDate;
    • private LocalDateTime localDateTime;
• @Enumerated: enum 타입 매핑
  • value(기본값: EnumType.ORDINAL)
    • EnumType.ORDINAL: enum 순서를 데이터베이스에 저장
    • EnumType.STRING: enum 이름을 데이터베이스에 저장
  • 주의
    • 기본값인 ORDINAL은 사용하지 않는 것이 좋음
    • enum 타입에 데이터가 추가되어도 테이블에는 이것이 반영되지 않기 때문에 이를 순서로 저장할 경우 문제가 발생하게 됨.
    • 따라서 필수적으로 STRING을 사용할 것!
• @Lob: BLOB, CLOB 매핑
  • 지정할 수 있는 속성이 따로 없음
  • 매핑하는 필드 타입이 문자이면 CLOB 매핑, 나머지는 BLOB 매핑
    • CLOB: String, char[], java.sql.CLOB
    • BLOB: byte[], java.sql.BLOB
• @Transient: 특정 필드를 컬럼에 매핑하지 않음(무시)
  • 데이터베이스에 저장, 조회 X
  • 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용

---

📝 기본 키 매핑

기본 키 매핑 어노테이션

• @Id
• @GeneratedValue

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

 

기본 키 매핑 방법

• 직접 할당: @Id만 사용
• 자동 생성(@GeneratedValue)
  • IDENTITY: 기본 키 생성을 데이터베이스에 위임
  • SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용
  • TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
  • AUTO: 방언에 따라 자동 지정, 기본값

 

📜 IDENTITY

• 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용
  • ex) MySQL의 AUTO_INCREMENT
• IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL을 실행하고 DB에서 식별자를 조회한다.
  • JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL문을 실행한다.
  • AUTO_INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID 값을 알 수 있다.
  • 이 경우 즉시 SQL문을 날리지 않으면 객체를 영속성 컨텍스트의 1차 캐시에 저장할 수가 없게 됨.

@Entity
public class Member {

	@Id
	@GeneratedValue(strategy = GenerationType.IDENTITY)
	private Long id;
    
	//...
}

 

📜 SEQUENCE

• 데이터베이스 시퀀스란 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트이다.
  • ex) 오라클 시퀀스
• 주로 Oracle, PostgreSQL, DB2, H2 데이터베이스에서 사용
• @SequenceGenerator 필요
  • name: 식별자 생성기 이름(필수)
  • sequenceName: 데이터베이스에 등록되어 있는 시퀀스 이름(기본값: hibernate_sequence)
  • initialValue: DDL 생성 시에만 사용됨, 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정(기본값: 1)
  • allocationSize: 시퀀스 한 번 호출에 증가하는 수
    • 성능 최적화에 사용됨
    • 주의: 데이터베이스 시퀀스 값이 하나씩 증가하도록 설정되어 있으면 이 값을 반드시 1로 설정해야 함(기본값: 50)
  • catalog, schema: 데이터베이스 catalog, schema 이름

@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

• 키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략
  • 장점: 모든 데이터베이스에 적용 가능
  • 단점: 성능 하락
• @TableGenerator 필요
  
  • name: 식별자 생성기 이름(필수)
  • table: 키생성 테이블 명(기본값: hibernate_sequences)
  • pkColumnName: 시퀀스 컬럼명(기본값: sequence_name)
  • valueColumnName: 시퀀스 값 컬럼명(기본값: next_val)
  • pkColumnValue: 키로 사용할 값 이름(기본값: 엔티티 이름)
  • initialValue: 초기 값, 마지막으로 생성된 값이 기준(기본값: 0)
  • allocationSize: 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용, 기본값: 50)
  • catalog, schema: 데이터베이스 catalog, schema 이름
  • uniqueConstraints: 유니크 제약 조건 지정

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;

	//...
}

 

📜 권장하는 식별자 전략

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

---

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

📜 요구사항 분석

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

 

📜 기능 목록

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

 

📜 도메인 모델 분석

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

 

📜 테이블 설계

 

📜 엔티티 설계와 매핑

 

 

데이터 중심 설계의 문제점

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