엔티티 매핑(Entity Mapping)

🔎 엔티티(Entity)란? 

JPA를 사용해서 테이블과 매핑할 클래스는 @Entity를 꼭 붙여야 한다. 이는 JPA가 관리하는 클래스이고, 데이터의 집합을 의미한다.

 

@Entity 사용 시 주의사항

기본 생성자는 필수(파라미터가 없는 public or protected 생성자)

public Member()

final, enum, interface, inner 클래스는 사용 불가

저장할 필드에 final 사용 불가

 

@Entity 속성

• name
  • JPA에서 사용할 엔티티 이름을 지정해준다.
  • 기본값 : 클래스 이름을 그대로 사용(ex) Member)

 

@Table 

엔티티와 매핑할 테이블을 지정해주는 어노테이션 생략 시, 매핑한 엔티티 이름을 테이블 이름으로 사용한다.

@Table 속성

• name
  • 매핑할 테이블 이름
    • 기본값 : 엔티티 이름 사용
• catalog
  • catalog 기능이 있는 DB에서 catalog를 매핑한다.
• schema
  • schema 기능이 있는 DB에서 schema를 매핑한다.
• uniqueConstraints(DDL)
  • DDL 생성 시 유니크 제약 조건을 생성한다.

 

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

hibernate.hbm2ddl.auto 속성

되도록이면 개발할 때만 사용하는 것을 추천한다.

 

🔹 사용 예시

persistence.xml에 아래 속성을 추가한다.

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

• create
  • 기존 테이블 삭제 후 다시 생성 (DROP + CREATE)
  • 혼자 빠르게 개발할 때 유용하다.
• create-drop
  • create와 같으나 종료시점에 테이블을 DROP 한다.
• update
  • 변경분만 반영, 삭제는 반영 안 함.
• validate
  • 테이블과 엔티티 매핑정보를 비교해서 차이가 있으면 경고를 남기고 애플리케이션을 실행하지 않는다. 따로 DDL을 수정하지 않는다. 
• none
  • 사용하지 않는다는 의미

 

사용 시 주의할 점

운영 장비에는 절대 create, create-drop, update 사용하지 말 것

 

DDL(Document Type Definition) 생성 기능

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

• 제약 조건 추가
  • 회원 이름은 필수이고, 10자 초과하면 안 될 경우

@Column(nullable = false, length = 10)

• 유니크 제약 조건 추가

 @Table(uniqueConstraints = {@UniqueConstraint(name = "NAME_AGE_UNIQUE",
    						  columnNames = {"NAME","AGE"} )})

 

매핑 어노테이션 

1. Column

• 컬럼 매핑
• 속성
  • name
  • 필드와 매핑할 테이블의 컬럼 이름
  • 기본값 : 객체의 필드 이름

2. Enumerated

• enum 타입 매핑
• 속성
  • value
    • EnumType.ORDINAL(기본값) : enum 순서를 DB에 저장
    • EnumType.STRING : enum 이름을 DB에 저장
• 가급적이면 EnumType.STRING을 사용할 것

3. Temporal

• 날짜 타입 매핑
• 그러나, LocalDate(년월), LocalDateTime(년월일)을 사용할 때는 생략이 가능하다.
• 속성
  • value
  • TemporalType.DATE : 날짜, DB date 타입과 매핑 (ex) 2021-05-21)
  • TemporalType.TYPE : 시간, DB time 타입과 매핑 (ex) 21:29:59)
  • TemporalType.TIMESTAMP : 날짜와 시간, DB timestamp 타입과 매핑 (ex) 2021-05-21 21:29:59)

4. Lob

• BLOB, CLOB 매핑
• 별도의 속성은 없음.

5. Transient

• 특정 필드를 컬럼에 매핑하지 않음(매핑 무시)
• DB에 저장하거나 조회하지 않는다.
• 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용한다.

 

기본 키 매핑 

기본 키 매핑 방식

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

• 직접 할당하는 경우
  • @Id만 작성해주기
• 자동 생성하는 경우
  • @GeneratedValue 작성해주기

 

권장하는 식별자 전략

• 기본 키 제약 조건
  • null 값은 허용하지 않는다.
  • 유일해야 한다.
  • 변하면 안 된다.
• 권장하는 바
  • Long 타입 (int, integer 보단 Long 권장, 왜냐하면 숫자가 엄청나게 커졌을 때 문제가 발생할 수 있기 때문에) + 대체키 + 키 생성전략 사용

---

출처 : 인프런 김영한 - 자바 ORM 표준 JPA 프로그래밍(기본편)