🔎 엔티티(Entity)란?
JPA를 사용해서 테이블과 매핑할 클래스는 @Entity를 꼭 붙여야 한다. 이는 JPA가 관리하는 클래스이고, 데이터의 집합을 의미한다.
@Entity 사용 시 주의사항
- 기본 생성자는 필수(파라미터가 없는 public or protected 생성자)
public Member()
- final, enum, interface, inner 클래스는 사용 불가
- 저장할 필드에 final 사용 불가
@Entity 속성
- name
- JPA에서 사용할 엔티티 이름을 지정해준다.
- 기본값 : 클래스 이름을 그대로 사용(ex) Member
@Table
엔티티와 매핑할 테이블을 지정해주는 어노테이션
생략 시, 매핑한 엔티티 이름을 테이블 이름으로 사용한다.
@Table 속성
- name
- 매핑할 테이블 이름
- catalog
- catalog 기능이 있는 DB에서 catalog를 매핑한다.
- schema
- schema 기능이 있는 DB에서 schema를 매핑한다.
- uniqueConstraints(DDL)
- DDL 생성 시 유니크 제약 조건을 생성한다.
데이터베이스 스키마 자동 생성
hibernate.hbm2ddl.auto 속성
: 되도록이면 개발할 때만 사용하는 것을 추천한다.
🔹 사용 예시
persistence.xml에 아래 속성을 추가한다.
<property name="hibernate.hbm2ddl.auto" value="create" />
- create
- 기존 테이블 삭제 후 다시 생성 (DROP + CREATE)
- create-drop
- create와 같으나 종료시점에 테이블을 DROP 한다.
- update
- 변경분만 반영, 삭제는 반영 안 함.
- validate
- 테이블과 엔티티 매핑정보를 비교해서 차이가 있으면 경고를 남기고 애플리케이션을 실행하지 않는다. 따로 DDL을 수정하지 않는다.
- none
- 사용하지 않는다는 의미
사용 시 주의할 점
- 운영 장비에는 절대 create, create-drop, update 사용하지 말 것
DDL(Document Type Definition) 생성 기능
: 이 기능은 DDL을 자동 생성할 때만 사용되고, JPA의 실행 로직에는 영향을 미치지 않는다.
- 제약 조건 추가
- 회원 이름은 필수이고, 10자 초과하면 안 될 경우
@Column(nullable = false, length = 10)
@Table(uniqueConstraints = {@UniqueConstraint(name = "NAME_AGE_UNIQUE",
columnNames = {"NAME","AGE"} )})
매핑 어노테이션
1. Column
- 컬럼 매핑
- 속성
- name
- 필드와 매핑할 테이블의 컬럼 이름
- 기본값 : 객체의 필드 이름
2. Enumerated
- enum 타입 매핑
- 속성
- value
- EnumType.ORDINAL(기본값) : enum 순서를 DB에 저장
- EnumType.STRING : enum 이름을 DB에 저장
- 가급적이면 EnumType.STRING을 사용할 것
3. Temporal
- 날짜 타입 매핑
- 그러나, LocalDate(년월), LocalDateTime(년월일)을 사용할 때는 생략이 가능하다.
- 속성
- value
- TemporalType.DATE : 날짜, DB date 타입과 매핑
(ex) 2021-05-21)
- TemporalType.TYPE : 시간, DB time 타입과 매핑
(ex) 21:29:59)
- TemporalType.TIMESTAMP : 날짜와 시간, DB timestamp 타입과 매핑
(ex) 2021-05-21 21:29:59)
4. Lob
- BLOB, CLOB 매핑
- 별도의 속성은 없음.
5. Transient
- 특정 필드를 컬럼에 매핑하지 않음(매핑 무시)
- DB에 저장하거나 조회하지 않는다.
- 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용한다.
기본 키 매핑
기본 키 매핑 방식
@Id @GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
- 자동 생성하는 경우
- @GeneratedValue
작성해주기
권장하는 식별자 전략
-
기본 키 제약 조건
- null 값은 허용하지 않는다.
- 유일해야 한다.
- 변하면 안 된다.
-
권장하는 바
Long 타입(int, integer 보단 Long 권장, 왜냐하면 숫자가 엄청나게 커졌을 때 문제가 발생할 수 있기 때문에) + 대체키 + 키 생성전략 사용
출처 : 인프런 김영한 - 자바 ORM 표준 JPA 프로그래밍(기본편)