@Entity
엔티티 클래스 지정
테이블과 매핑할 클래스에 붙이는 어노테이션, 해당 어노테이션을 통해 JPA가 클래스를 관리한다.
@Entity(name = "엔티티 지정명")
- name : 서로 같은 이름을 가지는 엔티티 클래스가 존재하면 해당 옵션을 통해 이름 설정을 변경해준다.
- @Entity 어노테이션에서 기본 생성자를 필수로 작성해야함. (@NoArgsConstructor)
- 필드에 final 예약어 X, final/enum/interface/inner 클래스에 사용 불가능
@Table
엔티티와 매핑할 테이블명을 지정
@Table(name = "매핑할 테이블명"): 매핑할 테이블의 이름을 직접 지정
(기본값: 엔티티 이름을 사용함)@Table(catalog = ): catlog 매핑@Table(schema = ): schema 매핑@Table(uniqueConstraints = ): 유니크 제약 조건 생성, DDL 쿼리에만 사용됨
ex)@Table(uniqueConstraints = {@UniqueConstraint(name = "제약조건 이름", columnNames={ "키 이름1", "키 이름2"})})
@Id
엔티티의 기본키를 명시하는 어노테이션
- 직접 할당 : 애플리케이션 단계에서 기본키 값을 직접 설정해줌.
- 기본키 미 설정시 영속성 컨텍스트에 저장시 예외 발생.
(javax.persistence.PersistenceException, org.hiberenate.id.IdentifierGenerationException)
- 기본키 미 설정시 영속성 컨텍스트에 저장시 예외 발생.
- 자동 생성 (옵션)
@GeneratedValue(strategy=GenerationType.옵션)어노테이션과 함께 사용가능하다.
(데이터 베이스마다 기본키 생성 전략이 모두 달라서 해당 옵션이 주어짐)
application.yml
spring:
jpa:
hibernate:
ddl-auto: none
use-new-id-generator-mappings: true| falseIDENTITY : 기본키 생성을 데이터베이스를 통해서 함.
AUTO_INCREMENT: 기본키 값을 획득 하기 위해 JPA는 데이터베이스를 추가로 조회해야함.- 데이터베이스에 선 INSERT 후 기본키 값을 획득 함. EntityManager.persist()호출 하자마자 INSERT SQL을 DB에 전달함. = 쓰기 지연 X
SEQUENCE : 데이터 베이스의 시퀀스를 이용하여 기본키 값을 할당.
@Entity @SequenceGenerator (name ="시퀀스 생성자 이름", sequenceName = "시퀀스 이름", initialValue = 1, allocationSize = 1) public class 엔티티클래스{ @Id @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "시퀀스 생성자 이름") private Long id; }
- 시퀀스를 사용하여 식별자 조회하고, 해당 식별 값을 엔티티와 함께 영속성 컨텍스트에 저장.
- 트랜젝션, 커밋 후에 해당 엔티티를 데이터베이스에 저장하게됨. (IDENTITY 와 반대)
- 쓰기 지연 O
- @SequenceGenerator
- name : 시퀀스 생성자 이름 (필수)
- sequenceName: DB에 등록된 시퀀스 이름
- initialValue : DDL 생성시에 지정할 시퀀스의 시작 번호
- allocationSize : 시퀀스 한번 호출에 증가하는 수 (Default: 50)
- catalog, schem : 데이터베이스 카탈로그, 스키마 이름
CREATE SEQUENCE [시퀀스이름] START WITH [시작 번호] INCREMENT BY [증가 단위]
TABLE : 키 생성 테이블을 사용
SEQUENCE 옵션을 모방
SEQUENCE 와 비슷하지만, 기본키를 조회한 후 UPDATE를 통해 한번 더 DB에 액세스함
-> allocationSize 옵션도 같이줘서 최적화 가능@Entity @TableGenerator (name ="테이블 생성자 이름", sequenceName = "테이블 이름", pkColumnValue = "기본키 이름", allocationSize = 1) public class 엔티티클래스{ @Id @GeneratedValue(strategy = GenerationType.TABLE, generator = "테이블 생성자 이름") private Long id; }
- name: 테이블 생성자 이름 (필수)
- table: 테이블 이름
- pkColumnName : 시퀀스 칼럼명
- valueColumnName : 시퀀스 값 칼럼명
- pkColumnValue : 키로 사용할 값 이름
- initailValue : 초기 값, 마지막으로 생성된 값 기준
- allocationSize : 시퀀스 한번 호출에 증가하는 수
- catalog, schema
- uniqueConstraints : 유니크 제약 조건 지정
AUTO : 자동
IDENTITY, SEQUENCE, TABLE 중 하나를 DB환경에 맞게 자동 선택
- SEQUENCE, TABLE의 생성자를 미리 만들어 놔야함..!
@Column
열에 속성을 지정하기위한 어노테이션
- name: 엔티티의 필드를 매핑할 테이블의 열 이름으로 지정할 수 있다.
- nullale: 해당 칼럼에 null 을 허용할지 안할지 여부 (defulat: true)
- length: 문자열 자료형의 길이를 지정 가능하다 VARCHAR(길이)
- insertable : 엔티티 저장 시 필드도 같이 저장.
- updatable : 엔티티 수정 시 필드도 같이 수정
- table : 하나의 엔티티를 두개 이상의 테이블에 매핑할 때 사용
- unique : 한 컬럼에 간단한 유니크 제약 조건 (두개이상은 @Table.uniqueConstraints사용)
- columnDefinition : 데이터 베이스 칼럼 정보를 직접 설정
- precision, scale : Decimal 타입 을 설정할때 사용
[precision-소수점을 포함한 전체 자리수, scale-소수의 자리수]
@Enumerated
자바의 enum을 사용하기 위한 어노테이션 매핑
@Enumerated(EnumType.ORDINAL) : enum 순서를 DB에 저장 (0, 1~~)
-> 이미 저장된 enum 순서번호를 변경 불가능, but 저장되는 크기가 작다
@Enumerated(EnumType.STRING) : enum 이름을 DB에 저장 (admin, user ~~)
-> enum 의 순서가 바뀌거나 추가되어도 상관 X, 데이터 크기가 좀 더 큼
@Temporal
자바의 날짜 타입 매핑 어노테이션
@Temporal(TemporalType.TIMESTAMP)
- TemporalType.DATE : YYYY-MM-DD
- TemporalType.TIME : HH:mm:ss
- TemporalType.TIMESTAMP : YYYY-MM-DD HH:mm:ss
@Lob
java.sql.*
길이 제한이 없는 문자열
- @CLOB : 문자열
- @BLOB : 바이트
@Transient
매핑을 하지 않는 필드를 지정
객체에 임시로 값을 저장할 때
@Acccess
JPA가 엔티티 데이터에 접근하는 방식
- 필드 접근 :
AccessType.FILED, private필드도 접근 가능 - 프로퍼티 접근 :
AccessType.PROPERTY(Getter 사용), Getter 함수에도 어노테이션 적용 가능
