엔티티 매핑

객체와 테이블 매핑 : @Entity , @Table
필드와 컬럼 매핑 : @Column
기본키 매핑 : @Id
연관관계 매핑: @ManyToOne , OneToMany

객체와 테이블 매핑

`@Entity`

이 어노테이션이 붙으면 JPA가 관리함.
JPA를 통해 테이블과 매핑할 클래스는 Entity 필수
name 속성 : JPA에서 사용할 엔티티 이름 설정 ( 기본값은 클래스 이름을 그대로 사용 )
- 기본 생성자 필수 ( JPA 내부적으로 자바 리플렉션을 사용하기 때문 )
- final 클래스, enum, interface, inner 클래스 사용 X
  - 저장할 필드에 final 사용 X

`@Table`

엔티티와 매핑할 테이블 지정
name 속성 : 매핑할 테이블 이름 ( 기본값은 엔티티 이름 사용 )
catalog 속성 : 데이터베이스에 catalog 매핑 ( catalog? )
schema 속성 : 추가적으로 넣고 싶은 schema 매핑
uniqueConsraints 속성 : DDL 생성 시에 유니크 제약조건 생성

스키마 자동 생성

DDL을 애플리케이션 실행 시점에 자동 생성
테이블 중심에서 객체 중심으로 전환
데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성
이렇게 생성된 DDL은 개발 장비에서만 사용!
- 생성된 DDL은 운영서버에서는 사용하지 않거나, 적절히 다듬은 후 사용하자
```
<property name="hibernate.hbm2ddl.auto" value="create" />
```
hibernate.hbm2ddl.auto : 데이터베이스 스키마 자동생성 - 속성
- create : 기존 테이블 삭제 후 다시 생성 ( DROP + CREATE )
- create-drop : create와 같으나 종료시점에 테이블 DROP
  - 테스트케이스 사용할 때 마지막에 깔끔하게 날리고 싶을 때 주로 사용
- update : 변경분만 반영 ( 운영 DB에는 사용하면 안됨 )
  - drop table이 아닌 alter table 하게 됨.
  - 지우는 건 안되고 추가하는 것만 가능
- validate : 엔티티와 테이블이 정상 매핑되었는지만 확인
- none : 사용하지 않음
  - 주의사항
    - 운영 서버에서 create, create-drop, update 사용하지 마라
    - 테스트서버와 운영 서버에서 그냥 쓰지 마라.
      
      update 시에도 시스템이 자동으로 alter 쳐준다는 것 자체가 락 유발 가능 -> 운영 중단될 수 있다.
    - 권장 사항은 본인이 직접 스크립트 작성해서 적용하는 것

DDL 생성기능

제약 조건 추가 기능
@Column(unique = true, length = 10, nullable=false)

유니크 제약조건 추가 기능

@Table(uniqueConstraints = 
    {@UniqueConstraint( name = "NAME_AGE_UNIQUE", columnNames = {"NAME", "AGE"} )})

DDL 생성 기능은 DDL 자동 생성 시에만 사용됨. JPA 실행 로직에는 영향 X

필드와 컬럼 매핑

@Id : pk 매핑
@Column : 컬럼 매핑
- name : 필드와 매핑할 컬럼 이름 설정
- insertable, updatable : insert나 update 할건지 안할건지
- nullable : null 허용여부
- unique : 유니크 제약조건 넣을 수 있음. 하지만 제약조건 이름이 이상하게 들어가므로 @Table에서 uniqueConstraints로 설정해주는 것이 바람직함.
- columnDefinition : 데이터베이스에 컬럼 정보를 직접 줄 수 있음
- length : 문자 길이 제약조건 (String 타입에만 사용)
@Enumerated(EnumType.STRING) : JPA에서 enum 타입을 쓰고 싶을 때 사용. DB에는 enum 타입이 없기 때문에 해당 어노테이션을 사용.
@Temporal : Date 타입을 매핑할 때 사용
- DATE , TIME , TIMESTAMP
- DB는 날짜 , 시간, 날짜+시간 을 구분해서 사용하기 때문에 해당 정보를 줘야함
- LocalDate, LocalDateTime 사용할 때는 생략 가능 ( 최신 하이버네이트에서 지원 )
@Lob : varchar를 넘어서는 굉장히 큰 정보를 넣고 싶을 때 사용 (clob, blob)
- 문자 필드 -> clob , 나머지 -> blob
@Transient : DB에 상관없이 메모리에서만 사용할 때 사용할 때 사용.

기본키 매핑

직접 할당 시에는 @Id만 사용
ID 자동 생성을 쓰려면 @GeneratedValue 사용

기본키 매핑 전략

@Entity
public class Member {
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     private Long id;

IDENTITY : 데이터베이스에 위임. ( like autoIncrement ) MySQL, SQL Server, DB2, PostgreSQL
- AUTO_INCERMENT는 DB에 INSERT 한 후에 ID 값을 알 수 있다.
- 영속성 컨텍스트에는 식별자가 존재해야한다 -> IDENTITY 전략은 커밋 시점에 INSERT하는게 아니라 em.persist() 한 시점에 INSERT SQL을 실행하여 식별자 가져옴
- 따라서 모아서 쿼리 쏘는 버퍼링 불가능

@Entity
@SequenceGenerator(
                  name = “MEMBER_SEQ_GENERATOR",
                  sequenceName = “MEMBER_SEQ", //매핑할 데이터베이스 시퀀스 이름
                  initialValue = 1, allocationSize = 1)
public class Member {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "MEMBER_SEQ_GENERATOR")
    private Long id;

SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용. ORACLE, PostgreSQL, DB2, H2
- @SequenceGenerator 필요
  - allocationSize 속성 : 시퀀스 한 번 호출에 증가하는 수 설정 가능 <- 매번 쿼리를 날려 시퀀스를 올리는 것이 아닌 50개~100개 정도 미리 가져와서 시퀀스를 저장해놓고 사용
TABLE : 키 생성용 테이블 사용. 모든 DB
- 테이블로 시퀀스 흉내냄. 모든 DB에 적용 가능하지만 성능 문제.. 비추
- @TableGenerator 필요
AUTO : 방언에 따라 자동 지정. 기본값

연관관계 매핑

테이블은 외래 키로 조인을 통해 연관된 테이블을 찾음
객체는 참조를 통해 연관된 객체를 찾음
이 차이를 극복하기 위한 매핑 필요

단방향 연관관계

JoinColumn 을 이용해 실제 테이블에 넣은 FK을 설정해준다.
ManyToOne : 다대일 관계로 매핑한다. ( 내가 다 )
OneToMany : 일대다 관계로 매핑한다. ( 내가 일 )

양방향 연관관계

테이블은 FK 하나로만 양방향 참조 가능
객체는 양쪽에서 참조를 가지고 있어야 양방향 참조 가능
객체에서 양방향 매핑을 하려면 ? 연관관계 주인 설정 필요 <- DB입장에서는 어느 값을 변경해야 FK 값을 변경시키지? 혼동이 생기기 때문
연관관계 주인 은 보통 테이블의 FK 위치에 따라서 설정함.
- 연관관계 주인은 외래키를 관리함 ( 등록, 수정 ). 반대쪽은 그저 조회만
- 주인이 아니면 mappedBy 속성으로 주인을 지정한다. (`mappedBy = "{주인의 필드명}")

양방향 연관관계에서 자주하는 실수

실수 1. 연관관계의 주인에 값을 입력하지 않고 역방향에 값을 입력

Team team = new Team();
team.setName("TeamA");
em.persist(team);

Member member = new Member();
member.setName("member1");

**//역방향(주인이 아닌 방향)만 연관관계 설정
team.getMembers().add(member);**

em.persist(member);

저장 시 저장이 잘 안되고 FK 값에 null이 들어가버림


Member member = new Member();
member.setUsername("member1");
em.persist(member);

Team team = new Team(); team.setName("TeamA"); //연관관계 주인에 값을 설정 member.setTeam(team); em.persist(team);

- 이러면 잘 들어감
- 객체지향적으로 생각해보면 객체 양쪽에 값을 넣어주는 것이 바람직하다.
- 연관관계 편의 메서드를 생성하자 ( 둘다 삽입하는 것을 까먹기 때문에 `changeTeam(Team team)` 같은 메서드를 정의해 안에서 두 작업을 다 해준다 )
```java
public void changeTeam(Team team){ 
        this.team = team;
        team.getMembers().add(this);
}

실수 2. 무한 루프를 조심하자

toString, lombok, json 자동생성 라이브러리 를 이용할때 무한 루프 발생될 가능성

👉 lombok의 toString() 만드는 것은 쓰지 마라. 쓰려면 이런 내용은 빼고 써라. 👉 컨트롤러에는 Entity를 절대 반환하지 마라. 엔티티를 API로 반환하지 마라.

양방향 매핑 정리

최대한 단방향 매핑으로 처음 설계를 끝내라. 추후 필요가 생기면 양방향 매핑을 고려하라
연관관계의 주인은 비즈니스 로직 기준으로 짜는게 아니라 데이터베이스의 외래키 위치를 기준으로 정해라

woowacourse-study / 2022-jpa-study

[섹션 4, 섹션 5] 로마 제출합니다 #10