엔티티 매핑

객체와 테이블 매핑

@Entity

  • Entity가 붙은 클래스는 JPA가 관리, 엔티티라고 한다.
  • JPA를 사용해서 테이블과 매핑하려는 클래스에는 @Entity를 필수로 붙여주어야 한다.
  • 주의사항
    • 기본 생성자 필수(public이나 protected 생성자)
    • final 클래스, enum, interface 사용 불가능
  • 속성
    • name
      • JPA에서 사용할 엔티티 이름을 지정한다.
      • 기본값: 클래스 이름을 그대로 사용
      • 가급적 기본값을 사용(같은 클래스 이름이 없다면)

@Table

  • Entity와 매핑할 테이블 지정
  • 속성
    • name
      • 매핑할 테이블 이름
      • 엔티티 이름을 사용
    • catalog
      • catalog 기능이 있는 데이터베이스 catalog 매핑
    • schema
      • schema 기능이 있는 데이터베이스 schema 매핑
    • uniqueConstraints(DDL)
      • DDL 생성 시에 유니크 제약 조건 생성

@Entity와 @Table의 차이

  • @Entity의 경우 JPA에서 엔티티를 지정할 때, 사용하는 것

  • @Table의 경우 실제 DB의 테이블에 사용하는 것

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

hibernate.hbm2ddl.auto

  • 속성
    • create
      • 기존 테이블 삭제 후 다시 생성(DROP + CREATE)
    • create-drop
      • create와 같으나 종료 시점에 테이블 DROP
    • update
      • 변경분만 반영
    • validate
      • 엔티티와 테이블이 정상 매핑되었는지만 확인
    • none
      • 사용하지 않음
  • 주의
    • 운영장비에는 절대 crate, create-drop, update 사용 금지
    • 개발 초기 단계에는 create 또는 update
    • 테스트 서버에는 update 또는 validate
    • 스테이징, 운영서버에는 validate 또는 none

매핑 어노테이션

@Column

  • 컬럼 매핑
  • 속성
    • name
      • 필드와 매핑할 테이블의 컬럼 이름
      • 기본값: 객체의 필드 이름
    • insertable, updateable
      • 기본값: True
    • nullable(DDL)
      • null값 허용 여부
      • false 시 not null 제약조건
    • unique(DDL)
      • @Table의 uniqueConstraints와 같지만, 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용
    • columnDefinition(DDL)
      • 데이터베이스 컬럼 정보를 직접 줄 수 있다.
    • length(DDL)
      • 문자 길이 제약조건, String 타입에만 사용
    • precision, scale(DDL)
      • BigDecimal 타입에서 사용
      • precision은 소수점을 포함한 전체 자릿수
      • scale은 소수 자릿수
      • double, float 타입에 적용되지 않고, 아주 큰 숫자나 정밀한 소수를 다룰 때에만 사용

@Enumerated

  • ORDINAL 사용 X -> 순서로 저장되면 enum 순서가 바뀌면 데이터가 엉망이 됨
  • 속성
    • EnumType.ORDINAL: enum 순서를 데이터베이스에 저장
    • EnumType.STRING: enum 이름을 데이터베이스에 저장
    • 기본값: EnumType.ORDINAL