[24.09.13] TIL

JAVA, JPA 공부중

엔티티 매핑

객체와 테이블 매핑

@Entity : JPA 관리하는 엔티티. 테이블과 매핑할 클래스는 @Entity 필수로 붙음.

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

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

• name : 매핑할 테이블 이름 (기본값: 엔티티 이름 사용)
• catalog : DB 카탈로그 매핑
• schema : DB 스키마 매핑
• uniqueContraints(DDL): DDL생성 시 유니크 제약 조건 생성

---

데이터베이스 스키마 자동 생성

• DDL을 애플리케이션 실행 시점에 자동생성 (create로 시작할 수 있음)
• DB 방언을 활용해서 DB에 맞는 적절한 DDL 생성
• 생성된 DDL은 개발 장비에서만 사용 (운영서버에서 사용하지 않거나 적절히 다듬은 후 사용해야함)

// 애플리케이션 실행하면 자동으로 테이블 drop해주고 클래스에 맞게 create도 자동으로 해줌
**<property name ="'hibernate.hbm2ddl.auto" value= "create"/>**

옵션

• create: 기존 테이블 삭제 후 다시 생성(drop + create)
• create-drop : create와 같으나 종료 시점에 테이블 drop (보통 테스크 케이스 할 때 사용)
• update: 변경분만 반영 (운영 DB에는 사용하면 안됨) alter add 만 됨. 지우는건 안됨.
• validate : 엔티티와 테이블이 정상 매핑되었는지만 확인
• none : 사용하지 않음

주의점

• 운영 장비에는 절대 create, create-drop, update 사용하면 안됨!
• 개발 초기 단계(로컬, 개발서버): create 또는 update
• 테스트 서버 : update 또는 validate
• 스테이징과 운영서버 : validate 또는 none

DDL 생성 기능

• 제약 조건 추가: 회원 이름을 필수, 10자 초과X -> @Column(nullable = false, length = 10)
• 유니크 제약 조건 추가 : @Table(uniqueContraints = {@UniqueContraint(name = "NAME_AGE_UNIQUE", columnNames = {"NAME", "AGE"})}
• DDL 생성 기능은 DDL을 자동 생성할 때만 사용되고, JPA의 실행 로직에는 영향을 주지 않음

---

필드와 컬럼 매핑

매핑 어노테이션

• @Column: 컬럼 매핑
• @Temporal : 날짜 타입 매핑
• @Enumerated : enum 타입 매핑
• @Lob : BLOB, CLOB 매핑
• @Transient : 특정 필드를 컬럼에 매핑하지 않음(매핑 무시)

@Column 속성

• name : 필드와 매핑할 테이블의 컬럼 이름 ( 객체의 필드 이름)
• insertable, updatable : 등록, 변경 가능 여부 (기본값 true)
• nullable(DDL) : null값 허용여부. (false - not null)
• unique(DDL) : @Table의 uniqueConsrtraints와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용
• columnDefinition(DDL) : DB컬럼 정보를 직접 줄 수 있음. 예) varchar(100) default 'EMPTY' (필드의 자바타입과 방언 정보를 사용)
• length(DDL) : 문자 길이 제약조건. String에서만 사용
• precision, scale(DDL) : BigDecimal, BigInteger 타입에서 사용. precision은 소수점을 포함한 전체자릿수, scale은 소수의 자릿수. double, float타입에는 미적용됨. 정밀한 소수 사용 시 사용.

@Enumerated 속성

• 기본값 : EnumType.ORDINAL
• EnumType.ORDINAL: enum 순서를 데이터베이스에 저장. (이걸로 하면 추후 enumType 요소를 추가할 때 버그가 생길 수 있음)
• EnumType.STRING: enum 이름을 데이터베이스에 저장 (이걸로 사용해야함)

@Temporal

• 날짜 타입을 매핑할 때 사용 (그냥 LocalDate, LocalDateTime 사용하면 됨)
• 최신 하이버네이트 지원 : LocalDate, LocalDateTime을 사용할 때는 생략 가능
• 구버전이면 : TemporalType.DATE, TemporalType.TIME, TemporalType.TIMESTAMP 사용

@Lob

• 데이터 베이스 BLOB, CLOB 타입과 매핑
• @Lob에는 지정할 수 있는 속성이 없음.
• 매핑하는 필드 타입이 문자면 CLOB, 나머지는 BLOB매핑
• CLOB : String, char[], java.sql,.CLOB
• BLOB: byte[], java.sql.BLOB

---

기본 키 매핑

@Id : 직접할당(@Id만 사용)

@GeneratedValue : 자동 생성

strategy = GenerationType.~
아래는 ~ 에 들어갈 속성값

• IDENTITY : DB에 위임. MYSQL
  - JPA는 보통 트랜잭션 커밋시점에 insert쿼리를 실행하는데

  • identity로 설정하면(pk값 자동생성) db에 들어가봐야 pk값을 알 수가 있음. 근데 영속컨텍스트에서 관리가 되려면 무조건 pk값이 있어야함. 그래서 예외적으로 트랜잭션 커밋되기 전 em.persist()가 실행될 때 insert쿼리가 실행되어버린다.

• SEQUENCE: DB 시퀀스 오브젝트 사용. ORACLE
  - @SequenceGenerator필요

  • name : 식별자 생성기 이름 (필수)
  • sequenceName : DB에 등록되어있는 시퀀스 이름
  • initialValue : DDL 생성 시에만 사용됨. 시퀀스 DDL을 생성할 때 처음 1 시작하는 수를 지정
  • allocationSize : 시퀀스 한 번 호출에 증가하는 수 ( 성능 최적화에 사용됨. DB 시퀀스 값이 하나씩 증가하도록 설정되어 있으면 이 값을 반드시 1로 설정해야함) (기본값 50)
  • catalog, schema : DB catalog, schema 이름

• TABLE : 키 생성 전용 테이블을 하나 만들어 DB시퀀스를 흉내내는 전략. 모든 DB에서 사용 가능. but 성능 저하
  - @TableGenerator 필요

  • name : 식별자 생성기 이름(필수)
  • talbe: 키 생성 테이블 명
  • pklColumnName : 시퀀스 컬럼명
  • valueColumnNa : 시퀀스 값 컬럼명
  • pkColumnValue: 키로 사용할 값 이름
  • initialValue : 초기값, 마지막으로 생성된 값이 기준 (기본값 0)
  • allocationSize : 시퀀스 한 번 호출에 증가하는 수 (성능 최적화에 사용됨) (기본값 50)
  • catalog, schema : DB catalog, schema 이름
  • uniqueContraints(DDL): 유니크 제약조건을 지정할 수 있음

• AUTO : 방언에 따라 자동 지정. 기본값

권장하는 식별자 전략

• 기본 키 제약 조건 : not null, unique (변하면 안됨)
• 대리키(대체키) 사용: 미래까지 이 조건을 만족시키는 자연키 찾기 어려움
• 주민번호도 기본키로 적절하지 않음
• 권장 : Long형 + 대체 키(예) UUID + 키 생성 전략 사용