04.md

04. 엔티티 매핑

🐣 이 글은 김영한님의 '자바 ORM 표준 JPA 프로그래밍'을 공부하며 정리한 것임을 알립니다.

4.1 @Entity

• 테이블과 매핑할 클래스는 @Entity 어노테이션은 필수

• 속성

  • name

    JPA에서 사용할 엔티티 이름 지정, 보통 기본값인 클래스 이름 사용

• 주의사항

  • 기본 생성자는 필수
  • final, enum, interface, inner 클래스에서는 사용 불가
  • 저장할 필드에 final 불가

4.2 @Table

• 엔티티와 매핑할 테이블을 지정

• 속성

  • name

    매핑할 테이블 이름, 기본값으로는 엔티티 이름 사용

  • catalog

    catalog 기능이 있는 디비에서 catalog를 매핑

  • schema

    schema 기능이 있는 디비에서 schema를 매핑

  • uniqueConstraints(DDL)

    DDL 생성 시에 유니크 제약조건을 만듦, 2개 이상의 복합 유니크 제약조건도 가능
    스키마 자동 생성 기능을 사용하여 DDL을 만들 때만 가능

4.3 다양한 매핑 사용

• 생략

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

• JPA는 데이터베이스 스키마를 자동으로 생성하는 기능을 지원(JPA 2.1부터는 자동 생성을 표준 지원, update, validate 옵션 X)

• 클래스의 매핑 정보와 데이터베이스 방언을 사용하여 스키마 생성

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

  다음과 같은 코드를 persistence.xml 에 추가하면 애플리케이션 실행 시점에 데이터베이스 테이블을 자동으로 생성

  • value에는 다음과 같은 옵션들이 들어감
    • create : 기존 테이블 삭제 후 새로 생성
      (개발 초기, CI 서버)
    • create-drop : create 속성 + 종료시 테이블 제거
      (CI 서버)
    • update : 데이터베이스 테이블과 엔티티 매핑정보를 비교하여 변경 사항만 수정
      (개발 초기, 테스트 서버)
    • validate : 데이터베이스 테이블과 엔티티 매핑정보를 비교하여 변경 사항 발생시 경고 및 애플리케이션 실행 X (테스트 서버, 스테이징 서버, 운영 서버)
    • none : 자동 생성 기능을 사용 안할 시에는 유효하지 않은 값 작성(none도 유효하지 않은 값)
      (스테이징 서버, 운영 서버)

• <propery name="hibernate.show_sql" value="true" />

  참고로 해당 속성을 지정하면 콘솔에 실행되는 DDL을 출력

• <propery name="hibernate.ejb.naming_strategy" value="org.hibernate.cfg.ImproveNamingStrategy" />

  참고로 다음과 같은 속성을 사용하며 테이블 명 혹은 컬럼 명이 생략되면 카멜 케이스를 언더스코어 케이스로 매핑

4.5 DDL 생성 기능

• 컬럼에 다음과 같이 제약조건을 추가할 수 있음

  // not null, 길이 = 10
  @Column(name="NAME", nullable = false, length = 10)
  private String userName;

• @Table 에 uniqueConstraints 속성을 사용하면 유니크 제약조건을 추가할 수 있음

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

• 해당 기능들은 DDL을 자동으로 생성할 때만 사용되며 JPA의 실행 로직에는 영향을 주지 않음

4.6 기본 키 매핑

• JPA가 제공하는 데이터베이스 기본 키 생성 전략은 다음과 같음

  • 직접 할당 : 기본 키를 애플리케이션에서 직접 할당

    @Id 적용 가능 자바 타입

    • 기본형, 래퍼형
    • String
    • java.util.Date
    • java.sql.Date
    • java.math.BigDecimal
    • java.math.BigInteger

    기본 키 직접 할당 전략은 em.persist()로 엔티티를 저장하기 전 애플리케이션에서 기본 키를 직접 할당

  • 자동 생성 : 대리 키 사용 방식

    키 생성 전략이 다양한 이유는 데이터베이스 벤더마다 지원하는 방식이 다르기 때문
    ex) 오라클 - 시퀸스 제공 , MySQL - 시퀸스 미제공

    자동 생성 전략을 사용시에 @GeneratedValue 를 추가하고 원하는 키 생성 전략 선택
    이때, persistence.xml에 hibernate.id.new_generator_mappings=true라는 속성을 반드시 추가

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

      주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용

      데이터를 INSERT한 뒤에 기본 키 값을 조회 가능하므로 추가적인 데이터베이스 조회가 필요
      하지만 하이버네이트에서는 Statement.getGeneratedKeys() 를 사용하여 저장과 동시에 기본 기 값을 가져옴

      엔티티가 영속 상태가 되려면 식별자 값을 가지고 있어야하는데, 해당 전략은 데이터베이스를 한번 거쳐 식별자 값을 알아올 수 있으므로 '트랜잭션을 지원하는 쓰기 지연'이 동작하지 않음

    • SEQUENCE : 데이터베이스 시퀸스를 사용하여 기본 키를 할당

      시퀸스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트, 해당 전략은 이 오브젝트를 사용하여 기본 키 생성(Oracle, PostgreSQL, DB2, H2)

      @SequenceGenerator를 사용하여 시퀸스 생성 가능

      데이터베이스 시퀸스를 통해 식별자를 조회하는 추가 작업이 필요, 따라서 2번 통신

      1. 식별자를 구하기 위해 데이터베이스 시퀸스를 조회
      2. 조회한 시퀸스를 기본키 값으로 사용하여 데이터 저장

      JPA에서는 시퀀스에 접근하는 횟수를 줄이기 위해 @SequenceGenerator.allocationSize 를 사용
      이 값을 저장하여 한번에 시퀸스 값을 증가 시키고 해당 메모리에 시퀀스 값을 할당

    • TABLE : 키 생성 테이블 사용

      키 생성 전용 테이블을 만들고 이곳에 이름과 값으로 사용할 컬럼을 만들어 데이터베이스 시퀀스를 흉내내는 전략, 이는 테이블을 사용하는 모든 데이터베이스에 적용 가능

    • AUTO : 데이터베이스 방언에 따라 기본 키를 생성

      오라클 - SEQUENCE, MySQL - IDENTITY

      데이터베이스를 변경해도 코드를 수정할 필요가 없음

• 권장 식별자 선택 전략

  • 자연 키 : 비지니스에 의미가 있는 키(주민번호, 전화번호)
  • 대리 키 : 비지니스와 관련 없는 임의로 만들어진 키(시퀀스, auto_increment)
  • 자연 키 보다는 대리 키 권장
    • 전화번호로 키가 선정되면 전화번호가 없어질 수도 있고 변경될 경우가 다분
    • 비지니스 환경은 언제나 바뀔 위험이 도래
    • JPA에는 모든 엔티티에 일관된 방식으로 대리 키 사용을 권장

4.7 필드와 컬럼 매핑: 레퍼런스

• 생략