객체와 테이블을 매핑하는 것이다.
@Entity, @Table : 객체와 테이블 매핑
@Column : 필드와 컬럼 매핑
@Id : 기본 키 매핑
@ManyToOne,@JoinColumn : 연관관계 매핑
@Entity가 붙은 클래스는 JPA가 관리한다
JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수
기본 생성자 필수
final 클래스, enum, interface, inner 클래스 사용 불가
저장할 필드에 final 사용 불가
속성 : name
JPA에서 사용할 엔티티 이름을 지정한다.
실무에서 사용 X
@Table은 엔티티와 매핑할 테이블 지정
name : 매핑할 테이블 이름. 기본값은 엔티티 이름
catalog : 데이터베이스 catalog 매핑
schema : 데이터베이스 schema 매핑
uniqueConstraints : DDL 생성 시에 유니크 제약 조건 생성
DDL을 어플 실행 시점에 자동으로 생성
생성된 DDL은 운영서버에서는 사용하지 않거나 적절히 다듬은 후 사용해야 한다.
옵션
create : 기존 테이블 삭제 후 다시 생성
create-drop : create와 같으나 종료 시점에 테이블 DROP
update : 변경분만 반영(운영DB에서는 사용하면 안됨)
validate : 엔티티와 테이블이 정상 매핑되었는지 확인
none : 사용하지 않음
운영할때는 절대 create, create-drop, update 사용하면 안된다
개발 초기는 create, update
테스트 서버는 update, validate
스테이징과 운영 서버는 validate, none
제약조건 추가 - 회원 이름은 필수이고 10자 초과하며 안될경우
@Column(nullable = false, length = 10)
@Table(uniqueConstraints = {@UniqueConstraint(name = "NAME_AGE_UNIQUE", columnNames = {"NAME","AGE"} )})
DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고 JPA의 실행 로직에는 영향을 주지 않는다.
컬럼 매핑
name : 필드와 매핑할 테이블의 컬럼 이름,
insertable/updatable : 등록/변경 가능 여부,
nullable : null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다,
unique : @Table의 uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용한다,
columnDefinition : 데이터베이스 컬럼 정보를 직접 줄 수 있다,
length : 문자 길이 제약 조건. String 타입에만 사용,
precision/scale : BigDecimal 타입에서 사용. precision은 소수점을 포함한 전체 자릿수를, scale은 소수의 자릿수다. 아주 큰 숫자나 정밀한 소수를 다룰때만 사용한다.
자바 enum 타입을 매핑할 때 사용한다.
ORDINAL 사용하지말고 무조건 String으로
날짜 타입을 매핑할 때 사용한다.
최신 하이버네이트에서는 LocalDate, LocalDateTime을 사용할 때는 생략 가능하다.
데이터베이스 BLOB, CLOB 타입과 매핑
@Lob에는 지정할 수 있는 속성이 없다.
매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑
필드 매핑 안하게 해주는 어노테이션
데이터베이스에 저장하지않고 조회하지 않는다.
메모리상에서만 사용하고 싶을 때 사용한다.
직접 할당 : @Id만 사용
자동 생성 : @GeneratedValue 사용
IDENTITY : 데이터베이스에 위임
SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용
TABLE : 키 생성용 테이블 사용
AUTO : 방언에 따라 자동 지정
기본 키 생성을 데이터베이스에 위임
JPA는 트랜잭션 커밋 시점에 SQL 실행
AUTO_INCREMENT는 DB에 SQL을 실행한 이후에 ID값을 알 수 있다.
em.persist() 시점에 즉시 INSERT SQL 실행하고 DB에서 식별자 조회
유일한 값을 순서대로 생성하는 특별한 DB 오브젝트
allocationSize : 시퀀스 한번 호출에 증가하는 수. 디폴트 50. 값만큼 인서트 쿼리 쌓다가 날리므로 성능에 좋음. 하지만 중간에 서버가 내려가거나 하면 구멍이 생길 수 있다.
Long + 대체키 + 키 생성전략 사용
출처 : 인프런 자바 ORM 표준 JPA 프로그래밍 - 기본편