자바 ORM 표준 JPA 프로그래밍 - 엔티티 매핑

이 학습 자료는 김영한님의 인프런 강의를 참고해서 만들었습니다.

 

1. 엔티티 매핑의 종류

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

2. 객체와 테이블 매핑

2.1 @Entity

• JPA가 관리하는 클래스로, 엔티티라고 부른다.
• 테이블과 매핑할 클래스는 필수로 붙여준다.
• 주의사항
  • 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
  • final, enum, interface, inner클래스 사용 X

<속성>

• name
• 엔티티 이름을 지정
• 기본값 : 클래스 이름
• 가급적 기본값 사용(중복된 클래스 이름이 있을때만 변경)

 

2.2 @Table

• 엔티티와 매핑할 테이블(데이터베이스에 위치) 지정

<속성>

속성	기능	기본값
name	매핑할 테이블 이름	엔티티 이름을 사용
catalog	데이터베이스 catalog 매핑
schema	데이터베이스 schema 매핑
uniqueConstraints	DDL 생성 시에 유니크 제약 조건 생성

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

• DDL(Data Definition Language, 데이터베이스를 정의하는 언어로 데이터를 생성, 수정, 삭제하는 역할을 함)을 애플리케이션 실행 시점에 자동 생성
• 테이블 중심 → 객체 중심
• 데이터베이스 방언을 활용하여 적절한 DDL 생성
• DDL은 개발 장비에서만 사용해야하며 운영서버에서는 사용하지 않거나 적절히 다듬어야 한다.

 

3.1 속성

• hibernate.hdm2ddl.auto

옵션	설명
create	기존테이블 삭제 후 다시 생성(DROP + CREATE)
create-drop	create와 같으나 종료시점에 테이블 DROP
update	변경분만 반영(운영DB에는 사용하면 안됨), 컬럼을 지우는것은 반영x
validate	엔티티와 테이블이 정상 매핑되었는지만 확인
none	사용하지 않음

 

3.2 주의 사항

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

 

3.3 DDL 생성기능

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

4. 필드와 컬럼 매핑

4.1 매핑 어노테이션 정리

• hibernate.hbm2ddl.auto

어노테이션	설명
@Column	컬럼 매핑
@Temporal	날짜 타입 매핑
@Enumerated	enum 타입 매핑
@Lob	BLOB, CLOB 매핑
@Transient	특정 필드를 컬럼에 매핑하지 않음(매핑 무시)

 

4.2 @Column

속성	설명	기본값
name	필드와 매핑할 테이블의 컬럼 이름	객체의 필드 이름
insertable, updatable	등록, 변경 가능 여부	TRUE
nullable(DDL)	null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.
unique(DDL)	한 컬럼에 간단히 유니크 제약조건을 걸 때 사용하지만, 이름을 정확히 알 수 없다. → @Table의 uniqueConstraints를 주로 사용
columnDefinition(DDL)	데이터베이스 컬럼 정보를 직접 줄 수 있다. ex) varchar(100) default ‘EMPTY'	필드의 자바 타입과 방언 정보를 사용
length(DDL)	문자 길이 제약조건, String 타입에만 사용한다.	255
percision, scale(DDL)	BigDecimal 타입에서 사용한다(BigInteger도 사용할 수 있다). precision은 소수점을 포함한 전체 자 릿수를, scale은 소수의 자릿수 다. 참고로 double, float 타입에는 적용되지 않는다. 아주 큰 숫자나 정 밀한 소수를 다루어야 할 때만 사용한다. precision=19, scale=2	precision = 19, scale = 2

 

4.3 @Temporal

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

 

4.4 @Enumerated

속성	설명	기본값
value	EnumType.ORDINAL : enum 순서를 데이터베이스에 저장 EnumType.STRING : enum 이름을 데이터베이스에 저장	EnumType.ORDINAL

• ORDINAL은 사용하면 안된다. → enum의 정보를 추가하거나 제거할 때 값이 바뀔수가 있음

 

4.5 @Lob

• 매핑하는 필드의 타입이 문자면 CLOB, 나머지는 BLOB으로 매핑

 

4.6 @Transient

• 필드 매핑을 하지 않을 때 사용

 

5. 기본 키(Primary Key) 매핑

5.1 기본 키 매핑 어노테이션 정리

• @Id
• @GeneratedValue

 

5.2 기본 키 매핑 방법

• 직접 할당 : @Id만 사용
• 자동 생성(@GeneratedValue)
  • IDENTITY : 데이터베이스에 위임, MYSQL
  • SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용, ORACLE → @SequenceGenerator 필요
  • TABLE : 키 생성용 테이블 사용, 모든 DB에서 사용 → @TableGenrator 필요
  • AUTO : 방언에 따라 자동 지정, 기본값

- IDENTITY 전략

• 기본 키 생성을 데이터베이스에 위임
• 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용
• 트랜잭션 커밋 시점에 INSERT SQL 실행 ← 커밋할때 날라가는게 아님(영속성컨텍스트에 관리되게 하기 위해)
• AUTO-INCREMENT는 데이터베이스에 INSERT SQL을 실행한 이후에 ID값을 알 수 있음
• em.persist() 시점에 즉시 INSERT SQL 실행하고 DB에서 식별자를 조회

- SEQUENCE 전략

• 유일한 값을 순서대로 생성
• em.persist() 시점에 call next value 쿼리가 발생 ← 영속성컨텍스트에 관리되게 하기 위해
• 커밋을 할때 INSERT SQL 실행 → 버퍼링 가능
• 오라클, PostgreSQL, DB2, H2 데이터베이스에서 사용

• 속성	설명	기본값
  name	식별자 생성기 이름	필수
  sequenceName	데이터베이스에 등록되어 있는 시퀀스 이름	hibernate_sequence
  initialValue	DDL 생성 시에만 사용, 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정	1
  allocationSize	시퀀스 한 번 호출에 증가하는 수	50
  catalog, schema	데이터베이스 catalog, schema 이름

- TABLE 전략

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

• 속성	설명	기본값
  name	식별자 생성기 이름	필수
  table	키생성 테이블명	hibernate_sequence
  pkColumnName	시퀀스 컬럼명	sequence_name
  valueColumnNa	시퀀스 값 컬럼명	next_val
  pkColumnValue	키로 사용할 값 이름	엔티티 이름
  initialValue	초기 값, 마지막으로 생성된 값이 기준	0
  allocationSize	시퀀스 한 번 호출에 증가하는 수	50
  catalog, schema	데이터베이스 catalog, schema 이름
  uniqueConstraints(DDL)	유니크 제약 조건을 지정

6. 권장하는 식별자 전략

• 기본 키 제약 조건 : null이면 안됨, 유일해야 됨, 변하면 안됨.
  • 만족하는 기본키를 찾기 어렵기 때문에, 대리키(대체키)를 사용하다.
• Long형 + 대체키 + 키 생성전략을 사용해야 함.