[JPA] 2. Entity 매핑

📙Entity 매핑

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

1. @Entity

• @Entity가 붙은 클래스는 JPA가 관리, 엔티티라 한다.
• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수
• 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
• final 클래스, enum, interface, inner 클래스 사용X
• 저장할 필드에 final 사용 X

*속성: name

• JPA에서 사용할 엔티티 이름을 지정한다.
• 기본값: 클래스 이름을 그대로 사용(예: Member)
• 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

2. @Table

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

---

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

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

자동 생성 - 주의

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

DDL 생성 기능

• 제약조건 추가: 회원 이름은 필수, 10자 초과X
  -> @Column(nullable = false, length = 10)
• 유니크 제약조건 추가
  -> @Table(uniqueConstraints = {@UniqueConstraint( name = "NAME_AGE_UNIQUE", columnNames = {"NAME", "AGE"} )})
• DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향을 주지 않는다.

---

📕필드와 컬럼 매핑

1. @Column

2. @Temporal

• 날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용
• LocalDate, LocalDateTime을 사용할 때는 생략 가능
  

3. @Enumerated

• 자바 enum 타입을 매핑할 때 사용
• 주의! ORDINAL 사용X
  

4. @Lob

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

5. @Transient

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

---

📗기본 키 매핑

1. 직접 할당: @Id만 사용

2. IDENTITY 전략

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

3. SEQUENCE 전략

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

@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; 

@SequenceGenerator - 속성

4. TABLE 전략

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

create table MY_SEQUENCES ( 
	sequence_name varchar(255) not null, 
	next_val bigint, 
	primary key ( sequence_name ) 
)

@Entity 
@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 - 속성

권장하는 식별자 전략

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

---

Reference

[인프런] 자바 ORM 표준 JPA 프로그래밍 - 김영한