- 객체와 테이블 매핑: @Entity, @Table
- 필드와 컬럼 매핑: @Column
@Entity
@Entity가 붙은 클래스는 JPA가 관리, 엔티티라 한다.
- 주의
- JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수
- 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자)
- 저장할 필드에 final 사용 X
@Entity 속성 관리
- ex) @Entity (name=?)
- JPA에서 사용할 엔티티 이름을 지정한다.
- 기본값: 클래스 이름을 그대로 사용한다.
- 같은 클래스 이름이 없으면 가급적 기본값을 사용한다.
@Table
- @Table은 엔티티와 매핑할 테이블 지정
속성 기능 기본값
속성 | 기능 | 기본값 |
name | 매핑할 테이블 이름 | 엔티티 이름을 사용 |
catalog | 데이터베이스 catalog 매핑 | |
schema | 데이터베이스 schema 매핑 | |
uniqueConstraints | DDL 생성 시에 유니크 제약 조건 생성 |
데이터 베이스 스키마 자동 생성
- DDL을 애플리케이션 실행 시점에 자동 생성한다.
- 테이블 중심에서 객체 중심이 된다
- 데이터 베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL을 생성한다.
- 생성된 DDL은 개발장비에서만 사용하는 것이 원칙이다
- 생선된 DDL은 운영서버에서는 사용하지 않거나, 적절히 다듬은 후 사용한다.
데이터베이스 스키마 자동 생성 - 속성
hibernate.hbm2ddl.auto
create 기존 테이블 삭제 후 다시 생성한다(drop+ create)
create | 기존 테이블 삭제 후 다시 생성한다(drop+ create) |
create-drop | create와 같으나 종료 시점에 테이블 drop을 실행 |
update | 변경부분만 반영(운영 DB에는 사용 금지) - 추가되는 것만 적용 |
validate | 엔티티와 테이블이 정상 매핑 되었지만 확인 |
none | 사용하지 않음 |
데이터베이스 스키마 자동 생성 - 실습
- 스키마 자동 생성하기 설정
- 스키마 자동생성하기 실행, 옵션별 확인
- 데이터베이스 방언 별로 달라지는 것 확인(varchar)
데이터베이스 스키마 자동 생성 - 주의
- 운영 장비에는 절대 create, create-drop, update 사용하면 안된다.
- 개발 초기 단계에는 create or update
- 테스트 서버에는 update or validate
- 스테이징과 운영서버는 validate or none
DDL 생성 기능
- 제약조건 추가: 회원 이름은 필수, 10자 초과X
- ex) @Column(nullable= false, length=10)
- 유니크 제약조건 추가 rksmd
- DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향을 주지 않는다.
매핑 어노테이션
어노테이션 설명
어노테이션 | 설명 |
@Column | 컬럼매핑 |
@Temporal | 날짜 타입 매핑 |
@Enumerated | enum 타입 매핑 |
@Lob | BLOB, CLOB 매핑 |
@Transient | 특정 필드를 컬럼에 매핑하지 않음(매핑무시) |
@Column
속성 설명 디폴트
속성 | 설명 | 기본값 |
name | 필드와 매핑할 테이블의 컬럼 이름 | 객체의 필드 이름 |
insertable updatable |
등록, 변경 가능 여부 | TRUE |
nullable(DDL) | null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 추가 | |
unique(DDL) | @Table의 uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용 | |
columnDefinition(DDL) | 데이터베이스 컬럼 정보를 직접 줄 수 있다. | 필드의 자바 타입과 방언 정보를 사용해 |
length(DDL) | 문자 길이 제약조건, String 타입에만 해당 | 255 |
precision, scale(DDL) | BigDecimal 타입에서 사용한다(BigInteger도 사용할 수 있다). precision은 소수점을 포함한 전체 자 릿수를, scale은 소수의 자릿수 다. 참고로 double, float 타입에는 적용되지 않는다. 아주 큰 숫자나 정 밀한 소수를 다루어야 할 때만 사용 | precision=19, scale=2 |
@Enumerated
자바 enum 타입을 매핑할 때 사용
속성 설명 기본값
속성 설명 기본값
속성 | 설명 | 기본값 |
value | EnumType.ORDINAL: enum 순서를 데이터베이스에 저장 EnumType.STRING: enum 이름을 데이터베이스에 저장 |
EnumType.ORDINAL |
ORDINAL 사용 금지!!
@Temporal 날짜 타입(java.util.Date, java.util.Calendar)을 매핑할 때 사용
속성 설명 기본값
속성 | 설명 |
value | TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑 (예: 2013–10–11) TemporalType.TIME: 날짜, 데이터베이스 date 타입과 매핑 (에: 11:11:11) TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이스 timestamp 타입과 매핑(예: 2013–10–11 11:11:11) |
@Lob
데이터베이스 BLOB,CLOB타입과 매핑
- @Lob에는 지정할 수 있는 속성이 없다.
- 매핑하는 필드 타입이 문자면 CLOB매핑, 나머지는 BLOB매핑
- CLOB: String, char[], java.sql.CLOB
- BLOB: byte[], java.sql.BLOB
@Transient
- 필드 매핑하지 않는다.
- 데이터베이스에 저장, 조회하지 않는다.
- 주로 메모리상에서만 임시로 어떤 값을 보관하고 싶을 때 사용한다.
출처: 인프런 - 자바 ORM 표준 JPA 프로그래밍 - 기본편 김영한