[JPA] 4. 엔티티 매핑

지니🧸·2023년 2월 8일
JPAJavaORM
0

Spring Boot & JPA

목록 보기
11/35

본 문서는 인프런의 자바 ORM 표준 JPA 프로그래밍 - 기본편 (김영한) 강의를 공부하며 작성한 개인 노트입니다.

🪄 객체와 테이블 매핑

엔티티 매핑

  • 객체와 테이블 매핑: @Entity, @Table
  • 필드와 컬럼 매핑: @Column
  • 기본 키 매핑: @Id
  • 연관관계 매핑: @ManyToOne, @JoinColumn

@Entity

@Entity가 붙은 클래스 > JPA가 관리하는 엔티티

  • JPA를 사용해서 테이블과 매핑할 클래스는 해당 에노테이션 필수
  • 기본 생성자 필수 (parameter X, public/protected)
  • final, enum, interface, inner 클래스 X
  • 디비에 저장할 필드에는 final 사용 X

속성

  • name
    • @Entity(name = "")
    • JPA에서 사용할 엔티티 이름 지정
    • 기본값: 클래스 이름 그대로 사용
    • 가급적 기본 값 사용 (같은 클래스 이름 존재시 변경)

@Table

@Table - 엔티티와 매핑할 테이블 지정

속성

  • name - 매핑할 테이블 이름
    • 기본값: 엔티티 이름 사용
  • catalog - 디비 카탈로그 매핑
  • schema - 디비 스키마 매핑
  • uniqueConstraints (DDL) - DDL 생성 시에 유니크 제약 조건 생성

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

  • DDL을 앱 실행 시점에 자동생성
  • 테이블 중심 > 객체 중심
  • 디비 방언을 활용 > 디비에 적절한 DDL 생성
  • 개발 장비에서만 사용 (운영서버 X)

속성

<property name="hibernate.hbm2ddl.auto" value=""/>
  • persistence.xml에서 수정
    옵션 (value 값)
  • create - 기존 테이블 삭제 후 다시 생성
    • = DROP + CREATE
  • create-drop - create + 종료시점에 테이블 DROP
  • update - 변경분만 반영
    • 운영 디비에 사용 X
    • drop이 없어서 데이터가 유지됨
  • validate - 엔티티와 테이블이 정상 매핑되었는지만 확인
  • none

주의

  • 운영장비에는 절대 create/create-drop/update을 사용하면 안된다
  • 개발 초기 단계 - create/update
  • 테스트 서버 - update/validate
    • 여기에 create/create-drop을 쓰면 데이터가 날아갈 수 있음
  • 스테이징 & 운영 서버 - validate/none

DDL 생성 기능

  • 제약조건 추가 (예) 회원 이름은 필수, 10자 초과 X
    • `@Column(unique = true, length = 10)
  • DDL 생성 기능은 DDL 자동생성 시에만 사용 됨 > JPA 실행 로직에 영향 X

🌯 필드와 컬럼 매핑

어노테이션 정리

  • @Column - 컬럼 매핑
  • @Temporal - 날짜 타입 매핑
    • @Temporal(TemporalType.TIMESTAMP) - 날짜 타입 (Date, Time, TimeStamp)
  • @Enumerated - enum 타입 매핑
  • @Lob - BLOB, CLOB 매핑
  • @Transient - 특정 필드를 컬럼에 매핑하지 않음
    • 매핑 무시

@Column

속성

  • name - 필드와 매핑할 테이블의 컬럼 이름
    • 기본값: 객체의 필드 이름
  • insertable, updatable - 등록/변경 가능 여부
    • 기본값: true
  • nullable (DDL) - null 값의 허용 여부 설정
    • false > DDL 생성 시 not null 제약 조건 붙음
  • unique (DDL)
    • @Table의 uniqueConstraint와 같은 영향이지만 컬럼 단위
    • name 속성과 함께는 반영이 어려우니 테이블 단위로 주는게 나음
  • columnDefinition (DDL) - 디비 컬럼 정보를 직접 줌
    • 기본값: 필드의 자바 타입과 방언 정보를 사용
  • length (DDL) - 문자 길이 제약조건
    • String에만 사용
    • 기본값: 255
  • precision, scale (DDL)
    • BigDecimal, BigInt에 사용
    • double, float에 사용 X
    • precision > 소수점을 포함한 전체 자릿수
    • scale > 소수 자릿수

@Enumerated

Enum 타입을 매핑할 때 사용
속성

  • value
    • EnumType.ORDINAL (기본값) - enum 순서를 디비에 저장
      • enum에 값을 추가하면 순서가 뒤죽박죽이 됨
    • EnumType.STRING - enum 이름을 디비에 저장

@Temporal

날짜 타입 매핑 시 사용

  • 날짜 타입: java.util.Date, java.util.Calendar
  • LocalDate, LocalDateTime 사용시에는 생략 가능 (최신 하이버네이트 기능)

속성

  • value
    • TemporalType.DATE - 날짜, 디비 date 타입과 매핑
      • 2020-01-23
    • TemporalType.TIME - 시간, 디비 time 타입과 매핑
      • 22:23:45
    • TemporalType.TIMESTAMP - 날짜와 시간, 디비 timestamp 타입과 매핑
      • 2020-01-23 22:23:45

@Lob

디비 BLOB & CLOB 타입과 매핑

  • 지정 속성 없음
  • 매핑하는 필드 타입
    • 문자 > CLOB 매핑: String, char[], java.sql.CLOB
    • 나머지 > BLOB 매핑: byte[], java.sql.BLOB

@Transient

필드 매핑 X

  • 디비에 저장/조회 X
  • 메모리상에만 임시 보관

🦍 기본 키 매핑

기본 키

@Id, @GeneratedValue

@Id @GeneratedValue
private Long id;

기본 키 매핑 방법

  • 직접 할당 > @Id
  • 자동생성 > @Id @GeneratedValue

@GeneratedValue

@GeneratedValue(strategy = GenerationType.IDENTITY)

  • IDENTITY - 기본 키 생성을 디비에 위임
    • MySQL, PostgreSQL, SQL Server, DB2 (예) AUTO_INCREMENT (MySQL)
    • AUTO_INCREMENT는 디비에 INSERT SQL 실행 후에 디비에서 Id값 셋팅을 함
      • 디비에 들어가야지 Id값을 알 수 있음
    • JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL 실행
      • 영속성 컨텍스트에 관리되려면 pk값이 꼭 필요
      • 그래서 IDENTITY 전략 사용 시에는 em.persist() 시점에 즉시 INSERT SQL 실행 & 디비에서 식별자 조회
        • IDENTITY는 모아서 INSERT하는 것은 불가능 > 큰 성능 차는 없음
  • SEQUENCE - 디비 시퀀스 오브젝트 사용
    • 디비 시퀀스: 유일한 값을 순서대로 생성하는 특별한 디비 오브젝트
    • em.persist()를 실행하려면 pk가 필요하기 때문에 먼저 시퀀스 다음값을 가져옴
    • 테이블마다 시퀀스를 따로 관리하고 싶으면 @SequenceGenerator 필요
    • (예) 오라클, PostgreSQL, DB2, H2
    @Entity
@SequenceGenerator(
		name = "MEMBER_SEQ_GENERATOR", 
      sequenceName = "MEMBER_SEQ", // 매핑할 디비 시퀀스 이름
      initialValue = 1
      allocationSize = 1)
public class Member {
		@Id
      @GeneratedVlaue(strategy = GenerationType.SEQUENCE, 
      	generator = "MEMBER_SEQ_GENERATOR")
      private Long id;
}
    • @SequenceGenerator 속성
      • name - 식별자 생성기 이름
        • 기본값: 필수
      • sequenceName - 디비에 등록되어 있는 시퀀스 이름
        • 기본값: hibernate_sequence
      • initialValue - 시퀀스 DDL 생성시 처음 시작하는 수 지정
        • DDL 생성 시에만 사용
        • 기본값: 1
      • allocationSize - 시퀀스 한 번 호출에 증가하는 수
        • 기본값: 50
          • 디비에 미리 50까지 셋팅해놓고 메모리 상에서는 1씩 increment
        • 성능 최적화에 사용
        • 디비 시퀀스 값이 하나씩 증가하도록 설정돼 있으면 이 값을 반드시 1로 설정해야 함
      • catalog, schema - 디비 카탈로그/스키마 이름
  • TABLE - 키 생성용 테이블 사용
    • 키 생성 전용 테이블을 만들어서 디비 시퀀스를 흉내냄
    • 장점 - 모든 디비에 적용 가능
    • 단점: 성능
    @TableGenerator (
		name = "MEMBER_SEQ_GENERATOR", 
      table = "MY_SEQUENCES", 
      pkColumnValue = "MEMBER_SEQ", allocationSize = 1)
public class Member {
		@Id
      @GeneratedValue(strategy = GenerationType.TABLE, 
      	generator = "MEMBER_SEQ_GENERATOR")
      private Long id;
}
    • @TableGenerator 속성
      • name - 식별자 생성기 이름
        • 기본값: 필수
      • table - 키 생성 테이블명
        • 기본값: hibernate_sequences
      • pkColumnName - 시퀀스 컬럼명
        • 기본값: sequence_name
      • initialValue - 초기값
        • 마지막으로 생성된 값 기준
        • 기본값: 0
      • allocationSize - 시퀀스 한 번 호출에 증가하는 수
        • 성능 최적화에 사용
        • 기본값: 50
      • catalog, schema - 디비 카탈로그/스키마 이름
      • uniqueConstraints (DDL) - 유니크 제약 조건 지정
  • AUTO - 방언에 따라 자동 지정
    • 기본값

권장 식별자 전략

  • 기본키 제약 조건
    • not null
    • 유일
    • 변하면 안됨
  • 위 조건을 만족하는 자연키는 찾기 어려움 > 대리케 (대체키) 사용하자
  • 권장: Long + 대체키 + 키 생성전략 사용

🪖 실전 예제 1 - 요구사항 분석과 기본 매핑

도메인 모델 분석

  • 회원 & 주문: 회원은 여러 번 주문할 수 있다 > 일대다
  • 주문 & 상품: 주문할 때 여러 상품 선택 & 상품 여러번 주문 가능 > 다대다 > 일대다 & 다대일
profile
지니🧸
우당탕탕
이전 포스트

[JPA] 3. 영속성 관리

다음 포스트

[JPA] 5. 연관관계 매핑 기초

0개의 댓글