엔티티 매핑

이번 글에서는 JPA를 사용하는데 가장 중요한 엔티티와 테이블을 매핑하는 작업을 해볼 것이다.

매핑 어노테이션

JPA에서는 테이블과 엔티티를 정확하게 매핑할 수 있도록 여러가지 어노테이션을 지원한다.
- 객체와 테이블 매핑
- 기본 키 매핑
- 필드와 컬럼 매핑
- 연관관계 매핑
연관관계는 더욱 중요한 내용이므로 따로 다루기로 하고 이번 글에서는 이를 제외한 각 매핑 어노테이션들에 대해서 자세히 알아보자

객체와 테이블 매핑

@Entity
- JPA를 사용해서 테이블과 매핑할 클래스는 위 @Entity 어노테이션을 필수로 붙여야만 한다.
- 해당 어노테이션이 붙은 클래스는 JPA가 관리하는 것으로, 엔티티라고 부르게된다.
- 속성
  - name
    - JPA에서 사용할 엔티티 이름을 지정한다.
    - 보통 기본값인 클래스 이름을 사용하며 만약 다른 패키지에 이름이 같은 엔티티가 존재한다면 이름을 설정하여 충돌이 생기지 않도록 해야만 한다.
- 주의점
  - 기본 생성자는 필수로 만들어야만 한다.
  - enum, interface, inner 클래스에는 사용할 수 없다.
  - 클래스 및 필드에 final을 사용할 수 없다.
- 사용법
  - 단순히 클래스 위에 @Entity 어노테이션을 붙여 사용하면 된다.
```
@Entity
public class Member {
	public Member() {} // 기본 생성자 필수!!!
}
```
@Table
- @Table 어노테이션은 엔티티와 매핑할 테이블을 지정할 때 쓰인다.
- 생략하게되면 엔티티 이름이 테이블 이름으로 사용한다.
- 속성
  - name
    - 매핑할 테이블 이름을 입력한다.
    - 생략 시 기본값으로는 엔티티 이름을 사용한다.
  - catalog
    - catalog 기능이 있는 DB에서 catalog를 매핑한다.
  - schema
    - schema 기능이 있는 DB에서 schema를 매핑한다.
  catalog, schema는 DB 서버 측에서 정의하는 nameSpace이다.
- 테이블 스키마 자동생성 기능 (DDL-auto)
  - JPA는 DB 스키마를 자동으로 생성하는 기능을 지원한다.
  - 클래스의 매핑 정보를 보면 어떤 테이블에 어떤 컬럼을 사용하는지 알 수 있기에 이 매핑 정보와 데이터베이스 방언을 적절히 사용하여 스키마를 생성할 수 있다.
  - persistence.xml에 파일 안에 다음 내용을 추가하면 된다.
    - <property name="hibernate.hbm2ddl.auto" value="create"/>
      - value 속성
        
        create
        
        기존 테이블을 삭제하고 새로 생성한다.
        
        DROP + CREATE
        
        create-drop
        
        create 속성에서 끝날 때 생성된 테이블 삭제하는 기능이 추가됬다.
        
        DROP + CREATE + DROP
        
        update
        
        DB 테이블과 엔티티 매핑정보를 비교해서 변경 사항만 수정한다.
        
        validate
        
        DB 테이블과 엔티티 매핑정보를 비교해서 차이가 있으면 경고를 남기고 애플리케이션을 실행하지 않는다. (DDL 수정 X)
        
        none
        
        자동 생성 기능 사용하지 않음 (혹은 해당 property 삭제하면 됨)
    - 스프링 부트에서는 application.yml 혹은 application.properites에 추가하면 된다.
    <aside> 💡 알아두어야 할 점 & 주의 할 점 개발 혹은 테스트 환경이라면 상관없지만, DB 혹은 테이블을 통째로 지우고 생성하는 것은 큰 위험부담이 생긴다.
    
    이에 따라서 개발 시에 위 기능을 적극적으로 활용하여 공부하고, 운영 시에는 사용하지 않거나 하더라도 validate, none으로 사용하자.
    
    </aside>
  - 제약조건 설정
```
@Entity
@Table(name="MEMBER", uniqueConstraints = {@UniqueConstraint(
	name = "AGE_UNIQUE",
	columnNames = {"AGE"} )})
public class Memeber {
	@Id @Column(name = "ID")
	private String id;

	@Column(name = "NAME", nullable = false, length = 10)
	private String name;
}
```
    - 제약조건은 위와 같이 걸 수 있다.
    - @Column 어노테이션에서 nullable과 길이를 추가해줄 수 있다.
    - @Table 에서는 유니크 제약조건을 적용할 컬럼을 지정할 수 있다.
@Id
- @Id 어노테이션을 사용해서 Member의 기본키를 지정할 수 있다.
- 이와 같이 사용되는 기본 키의 값들이 생성되는 여러 전략들을 살펴보도록 하자.
- @GeneratedValues를 사용한다.
- 직접 할당
  - 기본 키를 애플리케이션에서 직접 할당한다.
  - member.setId("id1"); 처럼 일반적인 컬럼에 값을 넣을 때와 같다.
- IDENTITY - 자동 생성
  - INDENTITY - 값 생성을 DB에 위임하는 방법이다.
    - MySQL, PostgreSQL, SQL Server, DB2에서 사용된다.
      - 예로 들자면 MySQL의 AUTO_INCREMENT가 있다.
        
        @Id @GeneratedValues(strategy = GenerationType.IDENTITY) private Long Id; ----------------------------------------------------- private static voic logic(EntityManager em){ Board board = new Board(); em.persist(board); System.out.println(board.getId); }
      - 위와 같이 INDENTITY 전략을 사용할 수 있고, JPA는 기본 키 값을 얻어오기 위해 DB를 추가로 조회하게 된다.
      - 그렇기에 위 코드에서 em.persist()로 엔티티를 저장한 직후 .getId()를 통해 출력하게 되어도 저장시점에서 JPA가 값을 조회하였기 때문에 정상적으로 출력된다.
  - SEQUENCE - 시퀀스를 사용해서 기본 키를 할당한다.
    - 시퀀스는 유일한 값을 순서대로 생성하는 특별한 DB 객체이다.
      - Oracle, PostgreSQL, DB2, H2에서 사용된다.
      - 시퀀스는 아래와 같이 생성할 수 있다. CREATE SEQUENCE BOARD_SEQ START WITH 1 INCREMENT BY 1;
```
@Entity
@SequenceGenerator(
	name = "BOARD_SEQ_GENERATOR",
	sequenceName = "BOARD_SEQ",
	initialValue = 1, allocationSize = 1)
public class Board {
	@Id
	@GeneratedValue(strategy = GenerationType.SEQUENCE,
									generator = "BOARD_SEQ_GENERATOR")
	privat Long Id;
}
```
      - 시퀀스를 사용하려면 먼저 사용할 데이터베이스에 시퀀스를 매핑해야한다.
      - 그 후에 @GeneratedValue로 키 생성 전략을 SEQUENCE로 설정해주고, generator 속성을 통해서 위에서 설정한 생성기와 연결해주면 된다.
    - SEQUENCE 전략은 IDENTITY와 다르게 동작된다.
  - TABLE - 키 생성 테이블을 사용한다.
  정리
  - 영속성 컨텍스트는 엔티티를 식별자 값으로 구분하기 때문에 엔티티를 영속 상태로 만들려면 식별자 값이 반드시 있어야 한다.
  - em.persist() 이후 무슨 일이 일어나는지 전략 별로 간단히 정리해보자.

이렇게 엔티티와 데이터베이스 간 매핑하는 방법을 살펴보았다.

하지만 위 예제들에서는 항상 테이블이 한개 였기에, 다음에는 여러 테이블에 연관관계에 따라서 어떻게 매핑해야하는지 알아보도록 하자.

아래 내용은 매핑을 위한 어노테이션들을 정리함으로써 어떤 것들이 보기 위함이며, 깊게 생각하지는 말되 후에 사용할 때 참고하거나 더 깊게 정리해보는 것이 필요할 것 같다.

필드와 컬럼 매핑용 어노테이션 정리

@Column

객체 필드를 테이블 컬럼에 매핑할 때 사용된다.
가장 많이 사용되며 속성 중에서는 name, nullable이 주로 사용된다.
속성