엔티티 매핑(Entity Mapping)

jieunee·2021년 5월 22일
0
post-thumbnail

🔎 엔티티(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 프로그래밍(기본편)

profile
Back-End Developer 🌱

0개의 댓글