(JPA) 테이블 매핑 어노테이션

@Entity

---

@Entity가 붙은 클래스는 JPA가 관리

 

• 주의

   • 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)

   • final 클래스, enum, interface, inner 클래스 사용X

   • 저장할 필드에 final 사용 X

 

• 속성: name

   • JPA에서 사용할 엔티티 이름을 지정한다.

   • 기본값: 클래스 이름을 그대로 사용(예: Member)

   • 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.

 

 

@Table

---

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

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

 

매핑 어노테이션 정리

---

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

 

@Column

---

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

 

@Enumerated

---

자바 enum 타입을 매핑할 때 사용

주의! ORDINAL 사용X

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

 

@Temporal

---

날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용

 

참고: LocalDate, LocalDateTime을 사용할 때는 생략 가능(최신 하이버네이트 지원)

 

속성	설명	기본값
value	• TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑 (예: 2013–10–11) • TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑 (예: 11:11:11) • TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이 스 timestamp 타입과 매핑 (예: 2013–10–11 11:11:11)

 

@Transient

---

• 필드 매핑X

• 데이터베이스에 저장X, 조회X

• 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용

• @Transient private Integer temp;