[JPA] Entity 매핑 - 필드와 컬럼 매핑

JPA를 사용하는 데 가장 중요한 일은 엔티티와 테이블을 정확히 매핑하는 것이다.
그러려면 JPA의 매핑 어노테이션을 잘 사용해야한다.
JPA가 지원하는 어노테이션은 크게 4가지로 분류할 수 있다.

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

@Column

@Column 은 객체 필드를 테이블 컬럼에 매핑한다.
@Column 은 가장 많은 기능을 갖고 있는데, 다양한 속성들을 살펴보자.
(거의 사용하지 않는 속성은 제외하였다.)

👩🏻‍🏫 nullable Ex.

@Column(nullable = false)
private String data;

// 생성된 DDL
// data varchar(255) not null

👩🏻‍🏫 unique Ex.

@Column(unique = true)
private String username;

// 생성된 DDL
// alter table TableName
//		add constraint UK_Xxx unique (username)

👩🏻‍🏫 columnDefinition Ex.

@Column(columnDefinition = "varchar(100) default 'EMPTY'")
private String data;

// 생성된 DDL
// data varchar(100) default 'EMPTY'

👩🏻‍🏫 length Ex.

@Column(length = 400)
private String data;

// 생성된 DDL
// data varchar(400)

👩🏻‍🏫 percision, scale Ex.

@Column(precision =10, scale = 2)
private BigDecimal cal;

// 생성된 DDL
// cal numeric(10,2)	H2, PostgreSQL
// cal number(10,2)		Oracle
// cal decimal(10,2)	MySQL

🚨 자바 데이터 타입(Primitive type) 과 @Column
@Column 은 기본적으로 nullable이다.
때문에 null 값을 허용하지 않는 자바 데이터 타입 의 경우 @Column (nullable = false) 로 지정해야 안전하다. 만약, Integer 와 같은 객체 타입(Reference Type)이라면 @Column 을 생략해도 무방하다.

@Enumerated

자바의 enum 타입을 매핑할 때 유용하게 사용된다.

@Enumerated 를 사용할 때는 기본값인 EnumType.ORDINAL 보다는
EnumType.STRING 을 사용하는 것이 안전하다.
💡 왜냐하면, enum 클래스 내부에 정의된 순서가 항상 같을 것이라는 보장이 없기 때문이다. enum의 추가나 삭제 등으로 순서가 바뀌게 된다면, 데이터베이스 무결성을 해칠 수 있다.

다음과 같은 enum 클래스가 있을 경우

enum RoleType {
	ADMIN, USER
}

Entity에는 이렇게 매핑을 한다.

@Enumerated(EnumType.STRING)
private RoleType roleType;

코드를 작성할 때, 아래처럼 사용하면 된다.

memebr.setRoleType(RoleType.ADMIN); // -> 테이블의 role_type 컬럼에 'ADMIN'으로 저장된다.

만약, EnumType.ORDINAL 로 매핑을 했을 경우엔
데이터베이스에는 ADMIN 이 아닌 0 값이 저장된다.

@Temporal

날짜 타입을 매핑할 때 사용한다. (java.util.Date, java.util.Calendar)
하지만 Java8 이상 부터 사용 가능한 LocalDate, LocalDateTime 타입을 사용하면 생략 가능하다.

@Temporal(TemporalType.DATE)
private Date date; //날짜

@Temporal(TemporalType.TIME)
private Date time; //시간

@Temporal(TemporalType.TIMESTAMP)
private Date timestamp; //날짜와 시간

@Lob

데이터베이스 BLOB, CLOB 타입과 매핑한다.
@LOB 은 지정할 수 있는 속성이 없다.
매핑하는 필드 타입이 문자면 CLOB 으로 매핑하고, 나머지는 BLOB 으로 매핑한다.

@Transient

@Transient 를 붙이면 해당 필드는 매핑하지 않는다.
데이터베이스에 저장하지 않고, 조회하지도 않기 때문에 객체에 임시로 값을 보관하고 싶을 때 사용한다.

참고

강의_자바 ORM 표준 JPA 프로그래밍 - 기본편
교재_자바 ORM 표준 JPA 프로그래밍(김영한)

다정한 피드백 환영해요 🤗