JPA 엔티티 매핑

Step 1: 객체와 테이블 매핑

@Entity

• @Entity가 붙은 클래스는 JPA가 관리하는 객체이다.

• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수

• 주의
  • 기본 생성자 필수 (파라미터가 없는 public 또는 protected 생성자)
  • final 클래스, enum, interface, inner 클래스 사용 X
  • 저장할 필드에 final 사용 X
• 속성 : name
  • JPA에서 사용할 엔티티 이름을 지정한다.
  • 기본값 : 클래스 이름을 그대로 사용
  • 같은 클래스 이름이 없으면 가급적 기본 값을 사용한다.

Step 2: 데이터베이스 스키마 자동 생성

• DDL을 애플리케이션 실행 시점에 자동 생성

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

  • JPA에서는 애플리케이션 로딩 시점에 DB TABLE을 생성하는 기능을 지원한다.
    하지만, 실제 운영에선 사용하면 안되고 개발이나 로컬단계에서 사용하기에 유용하다.

• 테이블 중심 -> 객체 중심

• 데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성

• 주의

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

• DDL 생성 기능

  • 제약조건 추가 : ex) 회원 이름은 필수, 10자 초과X
    • @Column(nullable = false, length = 10)
  • 유니크 제약 조건 추가
    • ex) @Column(unique = true)
  • DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향을 주지 않는다.

Step 3: 필드와 컬럼 매핑

• @Column

  • ex) 객체는 username인데 DB Column은 name을 사용하고 싶을때 @Column(name=”name”) 을 이용한다.
  • insertable, updateable
    • [등록, 변경 가능 여부] 기본값 true
  • nullable(DDL)
    • null 값의 허용 여부 설정, false 설정 시 DDL 생성 시에 not null 제약 조건
  • unique(DDL)
    • @Table의 uniqueConstraint와 같지만 한 컬렘에 간단히 유니크 제약 조건을 걸 때 사용한다.
    • 유니크 제약조건 이름이 알아보기 힘들게 생성되기 떄문에 잘 쓰지 않는다.
  • columnDefinition(DDL)
    • 데이터 베이스 컬럼 정보를 직접 줄 수 있다.
    • ex) varchar(100) default ‘EMPTY’
  • length(DDL)
    • 문자 길이 제약조건, String 타입에만 사용한다.
  • precision, scale(DDL)
    • BigDecimal 타입에서 사용한다 (BigInteger도 사용 가능)
    • presicison은 소수점을 포함한 전체 자릿수를, scale은 소수의 자리수다. double, float타입에는 적용 되지 않는다.

• @Enumerated

  • 객체에서 Enum 타입을 사용하고 싶으면 @Enumerated 을 사용
  • EnumType.ORDINAL -> enum 순서를데이터베이스에 저장
  • EnumType.STRING -> enum 이름을 데이터베이스에 저장
  • 주의 !! ORIDINAL 사용 x
    • ENUM 순서가 중간에 바뀌면 다 엉커버리기 때문.

  
  

• @Temporal

  • 날짜 타입 (java.util.Date, java.util.Calendar)를 매핑 할때 사용
  • LocalDate, LocalDateTime을 사용할 때는 생략 가능 ( 최신 하이버네이트 지원)
  • DATE, TIME, TIMESTAMP 세가지 타입 사용 가능

  
  

• @Lob

  • VARCHAR를 넘어서는 큰 컨텐츠를 사용할 땐 @Lob 를 사용한다.
  • 매핑하는 필드 타입이 문자면 CLOB, 나머지는 BLOB 매핑
  • CLOB : String, char[], java.sql.CLOB
  • BLOB : byte[], java.sql.BLOB

  
  

• @Transient

  • DB랑은 관련없는 필드를 두고싶을 때 , 즉 메모리에만 두고 싶을 때 사용한다.

  
  

Step 4: 기본 키 매핑

• 기본 키 매핑 어노테이션

  • 직접 할당 -> @Id만 사용

  • 자동 생성 -> @GeneratedValue

    • IDENTITY : 데이터베이스에 위임 [Mysql, PostgreSQL, SQL Server, DB2]
      • ex) Mysql의 AUTO_INCREMENT
      • JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL 실행
      • AUTO_INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID값을 알 수 있음
      • IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL 실행 하고 DB에서 식별자 조회

    
    

    • SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용, ORACLE

      • @SequenceGenerator 필요
        • name -> 식별자 생성기 이름
        • sequenceName -> 데이터베이스에 등록되어 있는 시퀀스 이름
        • initialValue -> DDL 생성 시에만 사용됨, 시퀀스 DDL을 생성할 때 처음 1시작하는 수를 지정한다.
        • catalog, schema -> 데이터베이스 catalog, schema 이름
        • 시퀀스 전략은 JPA에서 em.persist 전에 시퀀스를 미리 가져온다.
        • allicationSize -> 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨) 기본 값 50

      
      

    • TABLE : 키 생성용 테이블 사용, 모든 DB에서 사용

      • @TableGenerator

      • 키 생성 전용 테이블을 하나 만들어서 테이터베이스 시퀀스를 흉내내는 전략이다.

      • 모든 데이터베이스에 적용이 가능하지만 성능이 떨어진다.

      • 운영에서는 테이블 전략은 비추..

        
        

    • AUTO : 방언에 따라 자동 지정, 기본값

---

권장 식별자 전략

• 기본 키 제약 조건 : null 아님, 유일, 변하면 안된다.
• 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대체키)를 사용하자.
• 권장 : Long형 + 대체키 + 키 생성 전략 사용

참조 - 자바 ORM 표준 JPA 프로그래밍 By 김영한