[JPA] Entity Mapping : 객체 ➡️ 테이블 매핑

JPA를 사용할 때 우선적으로 해야 할 일은 바로 엔티티와 테이블을 매핑하는 작업입니다.  JPA는 엔티티와 테이블을 매핑하기 위한 다양한 매핑 어노테이션을 지원합니다.

 

1. 객체와 테이블을 매핑할 때 : @Entity, @Table

 

2. 테이블에서 사용할 기본 키를 매핑할 때 : @Id

 

3. 객체의 필드와 테이블의 컬럼을 매핑할 때 : @Column

 

4. 테이블과 테이블간 연관관계 매핑 : @ManyToOne, @JoinColumn 등..

 

이번 포스팅에서는 어노테이션을 통해 Entity와 테이블을 매핑하는 방법에 대해 하나씩 알아보겠습니다. 

(연관관계 매핑은 다음 포스팅에서)

---

객체와 테이블 매핑

@Entity

JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 어노테이션을 필수적으로 붙여주어야 합니다.

 

주의할 점 : JPA가 엔티티 객체를 생성할 때는 기본 생성자를 사용하므로 @Entity 어노테이션이 붙은 클래스는 반드시 기본 생성자를 만들어 주어야 합니다. 자바는 기본적으로 기본 생성자를 작성하지 않아도 자동으로 생성해 주지만, 기본 생성자가 아닌 다른 생성자가 존재하는 경우에는 기본 생성자가 자동으로 만들어 지지 않기 때문에, 명시적으로 만들어 주어야 합니다.

 

예시

@Entity
public class Member {
	
    @Id
    private Long id;   
    private String name;
    
    public Member(){}
}

@Table

엔티티와 매핑할 테이블을 지정해주는 어노테이션입니다. ex) @Table(name="테이블명")

이 어노테이션을 생략하게 되면 JPA는 자동으로 클래스 이름을 테이블명으로 매핑합니다.

 

사용 예시

@Entity
@Table(name="MEMBERK")
public class Member {
	
    @Id
    private Long id;   
    private String name;
    
    public Member(){}
}

수동으로 지정해주게 되면 @Entity로 매핑된 클래스를 지정한 테이블명으로 매핑해줍니다.

 

name 외에도 @Table에 지정할 수 있는 다양한 속성이 있습니다.

• catalog : 카탈로그 기능에 있는 데이터베이스에서 catalog를 매핑
• schema : 스키마 기능이 있는 데이터베이스에서 schema를 매핑
• uniqueConstraints : DDL 생성 시에 유니크 제약조건 생성. 2개 이상의 복합 유니크 제약 조건도 가능! 스키마 자동 생성 기능을 사용해서 DDL을 만들 때만 사용됩니다.

uniqueConstraints 기능과 관련된 DDL 생성 기능은 조금 뒤에 자세히 알아보겠습니다.

---

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

JPA는 클래스의 매핑 정보를 보고 데이터베이스 스키마를 자동으로 생성해주는 기능을 제공합니다. 이 기능을 사용하면 애플리케이션 실행 시점에 데이터베이스 테이블이 자동으로 생성되므로 개발자가 일일히 테이블을 생성해주어야 하는 작업들을 생략할 수 있습니다.

 

이 기능을 사용하려면 persistence.xml에 다음 속성을 추가해주면 됩니다.

<property name="hibernate.hbm2ddl.auto" value="create" />

 

value 속성

• create : 기존 테이블을 삭제하고 새로 생성 (drop & create)
• create-drop : 기존 테이블을 삭제하고 새로 생성한 후 애플리케이션 종료 시 다시 테이블을 drop하는 방식 (drop + create + drop)
• update : 테이블의 변경사항만 Update
• validate : 엔티티와 테이블의 차이가 있으면 경고를 남기고 애플리케이션 실행하지 않음.
• none : 자동 생성기능 off

 

People 엔티티를 만들고 테스트를 해보았습니다.

@Entity
@Table(name = "PEOPLE")
public class People {

    @Id
    @Column(name = "id")
    private String id;

    @Column(name = "name")
    private String username;

    private Integer age;

    @Enumerated
    private RoleType roleType;

    @Temporal(TemporalType.TIMESTAMP)
    private Date createdDate;

    @Temporal(TemporalType.TIMESTAMP)
    private Date lastModifiedDate;

    @Lob
    private String description;

    public People() {
    }
}

 

log를 보면 테이블 생성정보를 알 수 있습니다.

Hibernate: 
    
    create table PEOPLE (
       id varchar(255) not null,
        age integer,
        createdDate timestamp,
        description clob,
        lastModifiedDate timestamp,
        roleType integer,
        name varchar(255),
        primary key (id)
    )

 

직접 만든 엔티티를 기반으로 스키마를 자동으로 만들어 주는 것을 확인할 수 있습니다. 이 기능은 엔티티와 테이블을 어떻게 매핑해야 하는지 알려주는 도구로 개발 서버에서만 사용하고 운영 서버에서는 사용하지 않도록 합시다. 

 

 

<참고자료>

• 자바 ORM 표준 JPA 프로그래밍, 김영한