자바 ORM 표준 JPA 프로그래밍 - 기본편 - sec04
출처 : JPA 기본편

엔티티 매핑

객체와 테이블 매핑(@Entity, @Table)

@Entity

• 얘가 붙은 클래스는 JPA가 관리하고 엔티티라고 함
• JPA를 사용해서 테이블과 매핑할 클래스는 얘가 필수임
• 기본 생성자 필수(파라미터가 없는 PUBLIC 또는 PROTECTED 생성자)
• final 클래스, enum, interface, inner 클래스 사용 불가
• 저장할 필드에 final 사용 X

@Entity 속성 정리

name

• JPA에서 사용할 엔티티 이름 지정
• 기본값 : 클래스 이름을 그대로 사용
• 같은 클래스 이름이 없다면 가급적 디폴트값 사용 권장

@Table

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

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

• DDL을 애플리케이션 실행 시점에 자동 생성
• 테이블 중심에서 객체 중심으로
• 데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성
• 생성된 DDL은 개발 장비에서만 사용
• 생성된 DDL은 운영서버에서는 사용하지 않거나, 적절히 다듬은 후 사용

속성

주의 사항

운영 장비에는 절대 create, create-drop, update 사용 ❌
개발 초기 : create || update
테스트 서버 : update || validate
스테이징 & 운영 서버 : validate || none

DDL 생성 기능

• 제약 조건 추가 : 회원 이름은 필수, 10자 초과 X
  @Column(nullable = false, length = 10)
• 유니크 제약 조건 추가 : unique는 애플리케이션에 영향을 주는 것이 아닌 데이터베이스에 영향을 줌
  @Table(uniqueConstraints = {@UniqueConstraint( name = "NAME_AGE_UNIQUE", columnNames = {"NAME", "AGE"} )})
  이름도 설정할 수 있어서 이 방법을 더 선호함

DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향 ❌

필드와 컬럼 매핑(@Column)

@Entity
public class Member {
  @Id
  private Long id;
  
  @Column(name = "name")
  private String username;
  private Integer age;
  
  @Enumerated(EnumType.STRING)
  private RoleType roleType;
  
  @Temporal(TemporalType.TIMESTAMP)
  private Date createdDate;
  
  @Temporal(TemporalType.TIMESTAMP)
  private Date lastModifiedDate;
  
  @Lob
  private String description;
  
  //Getter, Setter…
}

@Column

@Enumerated

@Temporal

@Lob

큰 컨텐츠를 사용하고자 할 때 사용
데이터베이스 BLOB, CLOB 타입과 매핑
• @Lob에는 지정할 수 있는 속성이 없다.
• 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑
• CLOB: String, char[], java.sql.CLOB
• BLOB: byte[], java.sql. BLOB

@Transient

• 필드 매핑X
• 데이터베이스에 저장X, 조회X
• 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용

기본 키 매핑(@Id)

직접 할당의 경우 @Id
자동 생성의 경우 @GeneratedValue

IDENTITY: 데이터베이스에 위임, MYSQL

@Entity
public class Member {

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;

- 기본 키 생성을 데이터베이스에 위임
- 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용 (예: MySQL의 AUTO_ INCREMENT)
- JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL 실행
- AUTO_ INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID 값을 알 수 있음
- IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL 실행하고 DB에서 식별자를 조회

SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE => @SequenceGenerator 필요

@Entity
@SequenceGenerator(
    name = “MEMBER_SEQ_GENERATOR",
    sequenceName = “MEMBER_SEQ", //매핑할 데이터베이스 시퀀스 이름
    initialValue = 1, allocationSize = 1)
    public class Member {
  
  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "MEMBER_SEQ_GENERATOR")
  private Long id;

- 데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트(예: 오라클 시퀀스)
- 오라클, PostgreSQL, DB2, H2 데이터베이스에서 사용

@SequenceGenerator

TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용 => @TableGenerator 필요

• 키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉
  내내는 전략
• 모든 데이터베이스에 적용 가능
• 성능에 단점이 있음

@TableGenerator

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

연관관계 매핑(@ManyToOne, @JoinColumn)

권장하는 식별자 전략

• 기본 키 제약 조건: null 아님, 유일, 변하면 안됨
• 미래까지 이 조건을 만족하는 자연키는 찾기 어려움 => 대리키(대체키)를 사용
• 예를 들어 주민등록번호도 기본 키로 적절하지 않음
• 권장: Long형 + 대체키 + 키 생성전략 사용