[JPA] 자바 ORM 표준 JPA 프로그래밍 Ch.4

1️⃣ @Entity

➡️ JPA 를 사용해서 테이블과 매핑할 클래스는 @Entity 어노테이션을 필수로 붙여야한다. @Entity 가 붙은 클래스는 JPA 가 관리하게 된다.

① 속성

name : JPA 에서 사용할 엔티티 이름을 지정한다. 디폴트값은 클래스 이름이다.

② 주의 사항

• 기본 생성자는 필수이다. (파라미터가 없는 public 또는 protected 생성자)
• final 클래스, enum, interface,k inner 클래스에는 사용할 수 없다.
• 저장할 필드에 final 을 사용하면 안된다.

2️⃣ @Table

➡️ 엔티티와 매핑할 테이블을 지정한다. 생략하면 매핑한 엔티티 이름을 테이블 이름으로 사용한다.

name : 매핑할 테이블 이름을 지정한다. 디폴트값은 엔티티 이름이다.

catalog : catalog 기능이 있는 DB 에서 catalog 를 매핑한다.

schema : schema 기능이 있는 DB 에서 schema 를 매핑한다. 

3️⃣ 다양한 매핑 사용

➡️ 회원 테이블에서 아래와 같은 조건들이 추가되었다.

1. 회원은 일반 회원과 관리자로 구분해야한다.
2. 회원 가입일과 수정일이 있어야 한다.
3. 회원을 설명할 수 있는 필드가 있어야 한다. (길이 제한 없음)

// Getter & Setter & Constructor 생략

@Entity
@Table(name="MEMBER")
public class Member {

    @Id
    @Column(name = "ID")
    private String id;
    
    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;
}

• @Enumerated : Java 의 enum 을 사용하기 위한 어노테이션. 현재 상황에서는 조건 1 을 만족하기 위해 사용한다.
• @Temporal : 자바의 날짜 타입을 사용하기 위한 어노테이션. 현재 상황에서는 조건 2 를 만족하기 위해 사용한다.
• @Lob : VARCHAR 대신 길이 제한이 없는 CLOB 을 사용하기 위한 어노테이션. 현재 상황에서는 조건 3 을 만족하기 위해 사용한다.

4️⃣ 데이터베이스 스키마 자동 생성

➡️ JPA 는 데이터베이스 스키마를 자동으로 생성하는 기능을 지원한다.

① hibernate.hbm2ddl.auto

<property name="hibernate.hbm2ddl.auto" value="{사용할 속성}">

➡️ 해당 속성을 추가하면 애플리케이션 실행 시점에 데이터베이스 테이블을 자동으로 생성한다.

옵션	설명
create	기존 테이블을 삭제하고 새로 생성한다. DROP + CREATE
create-drop	create 속성에 추가로 애플리케이션을 종료할 때 생성한 DDL 을 제거한다. DROP + CREATE + DROP
update	데이터베이스 테이블과 엔티티 매핑정보를 비교해서 변경사항만 수정한다.
validate	데이터베이스 테이블과 엔티티 매핑정보를 비교해서 차이가 있으면 경고를 남기고 애플리케이션을 실행하지 않는다. 이 설정은 DDL 을 수정하지 않는다.
none	자동 생성 기능 OFF

② hibernate.show_sql

<property name="hibernate.show_sql" value="true">

➡️ 해당 속성을 추가하면 콘솔 화면에서 실행되는 테이블 생성 DDL 을 출력할 수 있다.

5️⃣ DDL 생성 기능

➡️ 회원 테이블에서 아래  조건들이 추가되었다.

1. 회원 이름은 필수로 입력되어야 한다.
2. 회원 이름은 10자를 초과하면 안 된다.

// Getter & Setter & Constructor 생략

@Entity
@Table(name="MEMBER", uniqueConstraints = {@UniqueConstraint(
        name = "NAME_AGE_UNIQUE",
        columnNames = {"NAME", "AGE"} )}) // 추가
public class Member {
    // 생략
    
    @Column(name = "NAME", nullable = false, length = 10) // 추가
    private String username;
    
    // 생략
}

• @Column : nullable 을 false 로, length 를 10으로 설정하면서 조건을 만족했다.
• @Table : uniqueConstraints 속성을 통해서 제약조건을 파악할 수 있도록 했다.

➡️ 위 어노테이션들을 단지 DDL 을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향을 주지 않지만 개발자가 엔티티만 보고도 손쉽게 다양한 제약조건을 파악할 수 있는 장점이 있다.

7️⃣ 필드와 컬럼 매핑 : 레퍼런스

① @Column

➡️ 객체 필드를 테이블 컬럼에 매핑, 속성 중에는 name, nullable 이 주로 사용된다.

➡️ int (자바 기본 타입) 과 Integer (객체 타입) 을 비교했을 때 int 에는 null 이 들어갈 수 없으므로 nullable 을 false 로 지정하는 것이 좋다.

② @Enumerated

➡️ 자바의 enum 타입을 매핑할 때 사용된다.

// enum 타입
enum RoleType { 
	ADMIN, USER 
}

// Entity Column 형태
@Enumerated(EnumType.STRING) 
private RoleType roleType;

// 적용
member.setRoleType(RoleType.ADMIN);

➡️ DB 에는 ADMIN 으로 저장된다.

➡️ enum 을 사용하면 혹시나 발생할 수 있는 오타로 인한 오류를 방지할 수 있다.

③ @Temporal

➡️ 날짜 타입을 매핑할 때 사용된다. @Temporal 을 생략하면 TIMESTAMP 로 지정된다.

속성	기능	기본값
value	TemporalType.DATE: 날짜 네이터베이스 date 타입과 매핑(예: 2013-10-11)  TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑(예: 11:11:11) TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이스timestamp 타입과 매핑(예 2013-10-11 11:11:11)	TemporalType은 필수로 지정해야한다.

④ @Lob (= Large OBject)

➡️ 데이터베이스BLOB(= 이미지, 동영상 등), CLOB(= 문자 대형 객체) 타입과 매핑한다. 매핑하는 필드 타입이 문자면 CLOB 으로 매핑하고 나머지는 BLOB 으로 매핑한다.

⑤ @Transient

➡️ 객체에 임시로 값을 보관하고 싶을 때 사용한다. 따라서 DB 에 저장 또는 조회하지 않는다.

⑥ @Access

➡️ JPA 가 데이터에 접근하는 방식을 지정한다.

(1) 필드 접근 (AccessType.FIELD) : 필드에 직접 접근한다.

(2) 프로퍼티 접근 (AccessType.PROPERTY) : 접근자 (Getter) 을 통해 접근한다.