출처 : 자바 ORM 표준 JPA 프로그래밍 - 기본편
섹션 4. 엔티티 매핑
1. 객체와 테이블 매핑
1 - 1. @Entity
- @Entity가 붙은 클래스는 JPA가 관리, 엔티티라 함
- JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수
🚨 주의
- 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
- final 클래스, enum, interface, inner 클래스 사용X
- 저장할 필드에 final 사용 X
1 - 2 . @Entity 속성
속성: name
- JPA에서 사용할 엔티티 이름을 지정함
- 기본값: 클래스 이름을 그대로 사용(예: Member)
- 같은 클래스 이름이 없으면 가급적 기본값을 사용함
🚨 주의
- final 클래스, enum, interface, inner 클래스에는 사용할 수 X
- 저장할 필드에 final을 사용하면 X
JPA가 엔티티 객체를 생성할 때 기본 생성자를 사용하므로 이 생성자는 반드시 있어야 한다.
자바는 생성자가 하나도 없으면 기본 생성자를 자동으로 만든다.
public Member() {} // 기본 생성자🚨 문제는, 임의의 생성자를 하나 이상 만들면, 자바는 기본 생성자를 자동으로 만들지 않는다. 따라서 기본 생성자를 직접 만들어야 한다.
public Member() {} // 직접 만든 기본 생성자
// 임의의 생성자
public Member(String name) {
this.name = name;
}1 - 3. @Table
@Table은 엔티티와 매핑할 테이블 지정
2. 데이터베이스 스키마 자동 생성
DDL을 애플리케이션 실행 시점에 자동 생성
<property name="hibernate.hbm2ddl.auto" value="create" />2 - 0. 옵션
- create : 기존테이블 삭제 후 다시 생성 (DROP + CREATE)
- create-drop : create와 같으나 종료시점에 테이블 DROP
- update : 변경분만 반영(운영DB에는 사용하면 안됨)
- validate : 엔티티와 테이블이 정상 매핑되었는지만 확인
- none : 사용하지 않음
2 - 1. 🚨 주의
- 운영 장비에는 절대 create, create-drop, update 사용하면 안 됨!
2 - 2. 개발 초기
- create 또는 update
2 - 3. 테스트 서버
- update 또는 validate
2 - 4. 스테이징과 운영 서버
- validate 또는 none
2 - 5. DDL 생성 기능
예)
// 제약조건 추가: 회원 이름은 필수, 10자 초과X
@Column(nullable = false, length = 10)- DB에만 영향, JPA의 실행 로직에는 영향을 주지 않음
3. 필드와 컬럼 매핑
3 - 1. @Column
- name : 필드와 매핑할 테이블의 컬럼 이름 (기본값 : 객체의 필드 이름)
- nullable(DDL) : null 값의 허용 여부를 설정한다.
false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다. - length(DDL) : 문자 길이 제약조건, String 타입에만 사용한다. (기본값 : 255)
3 - 2. @Enumerated
자바 enum 타입을 매핑할 때 사용
🚨 주의 : ORDINAL 사용 X
- EnumType.ORDINAL : enum 순서를 데이터베이스에 저장 (기본값)
- EnumType.STRING : enum 이름을 데이터베이스에 저장
ex)
// Member 클래스
@Enumerated(EnumType.STRING)
private RoleType roleType;
// enum 클래스
public enum RoleType {
USER, ADMIN
}3 - 3. @Temporal
날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용
- 참고 : LocalDate(년/월), LocalDateTime(년/월/일)을 사용할 때는 생략 가능(최신 하이버네이트 지원)
예)
private LocalDate createdDate;4. 기본 키 매핑
4 - 1. 기본 키 매핑 방법
- @Id : 직접 할당
- @GeneratedValue : 자동 생성
ex)
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;4 - 2. 자동 생성(@GeneratedValue)
- IDENTITY: 데이터베이스에 위임, MYSQL
- SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE
• @SequenceGenerator 필요 - TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
• @TableGenerator 필요 - AUTO: 방언에 따라 자동 지정, 기본값
4 - 3. IDENTITY 전략 - 특징
- 기본 키 생성을 데이터베이스에 위임
- 주로 MySQL, PostgreSQL, SQL Server, DB2에서 사용
(예: MySQL의 AUTO_ INCREMENT)
Hello My World!