JPA - 임베디드(embedded) 타입


  • 기본값 타입
  • 임베디드 타입(embedded type, 복합 값 타입)

기본값 타입

JPA의 데이터 타입 분류

  • 엔티티 타입
    • @Entity로 정의하는 객체
    • 데이터가 변해도 식별자로 지속해서 추적 가능
    • 예) 회원 엔티티의 키나 나이 값을 변경해도 식별자로 인식 가능
  • 값 타입
    • int, integer, String처럼 단순히 값으로 사용하는 자바 기본 타입이나 객체
    • 식별자가 없고 값만 있으므로 변경시 추적 불가
    • 예) 숫자 100을 200으로 변경하면 완전히 다른 값으로 대체

값 타입 분류

  • 기본값 타입
    • 자바 기본 타입(int, double)
    • 래퍼 클래스(Integer, Long)
    • String
  • 임베디드 타입(embedded type, 복합 값 타입)
  • 컬렉션 값 타입(collection value type)

기본값 타입

  • 예) String name, int age
  • 생명 주기를 엔티티의 의존
    • 예) 회원을 삭제하면 이름, 나이 필드도 함께 삭제
  • 값 타입은 공유하면 X
    • 자바의 primitive type은 공유가 안됨
    • 예) 회원 이름 변경시 다른 회원의 이름도 함께 변경되면 안됨

임베디드 타입(embedded type, 복합 값 타입)

  • 새로운 값 타입을 직접 정의할 수 있음
  • JPA는 임베디드 타입(embedded type)이라 함
  • 주로 기본 값 타입을 모아서 만들어서 복합 값 타입이라고도 함
  • int, String과 같은 값 타입

Member는 id, name, workPeriod, homeAddress 4가지 타입을 가지고, Period는 2가지는 타입, Address는 3가지 타입을 가진다.

임베디드 타입 사용법

  • @Embeddable: 값 타입을 정의하는 곳에 표시
  • @Embedded: 값 타입을 사용하는 곳에 표시
  • 기본 생성자 필수

임베디드 타입의 장점

  • 재사용
  • 높은 응집도
  • Period.isWork()처럼 해당 값 타입만 사용하는 의미 있는 메소드를 만들 수 있음
  • 임베디드 타입을 포함한 모든 값 타입은, 값 타입을 소유한 엔티티에 생명 주기를 의존함

임베디드 타입과 테이블 매핑

Member
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Entity
class Member (
@Id
@GeneratedValue
var id: Long? = null,

@Column
var username: String? = null,

var startDate: LocalDateTime? = null,
var endDate: LocalDateTime? = null,

var city: String? = null,
var street: String? = null,
var zipcode: String? = null,
) {
}
result
1
2
3
4
5
6
7
8
9
10
create table Member (
id bigint not null,
city varchar(255),
street varchar(255),
zipcode varchar(255),
username varchar(255),
endDate timestamp,
startDate timestamp,
primary key (id)
)

Member 클래스에서 startDate, endDate를 Period로 묶고 city, street, zipcode을 Address로 묶어서 사용하면 다른 곳에서도 사용 가능하다는 장점이 있다.

Member
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@Entity
class Member (
@Id
@GeneratedValue
var id: Long? = null,

@Column
var username: String? = null,

// 기간 Period
@Embedded
var workPeriod: Period? = null,

// 주소 address
@Embedded
var homeAddress: Address? = null,
) {
}
Period
1
2
3
4
5
6
7
8
9
10
@Embeddable
class Period(
@Column
var startDate: LocalDateTime? = null,

@Column
var endDate: LocalDateTime? = null,
) {
}
`
Address
1
2
3
4
5
6
7
8
9
10
11
12
@Embeddable
class Address(
@Column
var city: String? = null,

@Column
var street: String? = null,

@Column
var zipcode: String? = null,
) {
}
result
1
2
3
4
5
6
7
8
9
10
create table Member (
id bigint not null,
city varchar(255),
street varchar(255),
zipcode varchar(255),
username varchar(255),
endDate timestamp,
startDate timestamp,
primary key (id)
)
jpaMain
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
fun main() {
val emf = Persistence.createEntityManagerFactory("hello")
val em = emf.createEntityManager()
val tx = em.transaction

tx.begin()

try {
val address = Address("city", "street", "1000")
val period = Period()

val member = Member(
username = "hello",
homeAddress = address,
workPeriod = period,
)

em.persist(member)

tx.commit()
} catch (e: Exception) {
tx.rollback()
} finally {
em.close();
emf.close();
}
}
result
1
2
3
4
5
6
7
/* insert entity.Member */
insert
into
Member
(city, street, zipcode, username, endDate, startDate, id)
values
(?, ?, ?, ?, ?, ?, ?)

임베디드 타입과 테이블 매핑

  • 임베디드 타입은 엔티티의 값일 뿐이다.
  • 임베디드 타입을 사용하기 전과 후에 매핑하는 테이블은 같다.
  • 객체와 테이블을 아주 세밀하게(find-grained) 매핑하는 것이 가능
  • 잘 설계한 ORM 애플리케이션은 매핑한 테이블의 수보다 클래스의 수가 더 많음

임베디드 타입과 연관관계

@AttributeOverride: 속성 재정의

  • 한 엔티티에서 같은 값 타입을 사용하면?
  • 컬럼 명이 중복됨
  • @AttributeOverrides, @AttributeOverride를 사용해서 컬럼 명 속성을 재정의

소스코드

참조