[JPA] 값 타입 정리(기본값, 임베디드, 컬렉션)

1. 개요

김영한 님의 '자바 ORM 표준 JPA 프로그래밍 - 기본편' 을 들으면서 정리하는 포스팅입니다.

 

https://www.inflearn.com/course/ORM-JPA-Basic

자바 ORM 표준 JPA 프로그래밍 - 기본편 강의 | 김영한 - 인프런

 

2. JPA의 데이터 타입 분류

JPA에서 데이터 타입을 분류할 때 2가지 타입으로 분류한다.

a. 엔티티(Entity) 타입

• @Entity로 정의한 객체
• PK 값으로 관리가 되기 때문에 데이터가 변해도 지속적으로 추적 가능
• ex) 회원 엔티티의 키나 나이 값을 변경해도 식별자로 인식 가능

 

b. 값(Value) 타입

• int, Integer, String, Address 처럼 단순히 값으로 사용하는 자바 기본 타입이나 객체
• 식별자가 없고 값만 있으므로 변경시 추적 불가
• 모든 값 타입은 소유한 엔티티의 생명주기에 의존
• ex) 숫자 100을 200으로 변경하면 완전히 다른 값으로 대체

값 타입에서 또 기본값 타입, 임베디드 타입, 값 타입 컬렉션 3가지로 분류할 수 있다. 

 

3. 값 타입과 종류

JAVA의 타입에 대해 제대로 알지 못하면, JPA의 값 타입 개념을 제대로 이해할 수 없다. JAVA의 기본 타입에 대해서 간략히 짚고 넘어가겠다.

 

JAVA에서 타입은 Primitive/Reference 타입으로 구분된다. 

Primitive 타입

• int, long, double 등이 해당
• value 자체를 복사해서 사용하며, value를 절대로 공유하지 않는다.

Reference 타입

• Integer, String, 사용자 정의 객체 등
• Value를 저장 공간에 저장하고, 해당 저장 공간의 주소(Reference)를 통해 값을 참조하므로 value 공유가 가능하다.

 

JPA에서 값 타입을 알아보자.

 

a. 기본값 타입(primitive value type)

• JAVA의 Primitive 타입과 Primitive 타입의 래퍼 클래스가 해당된다. => 값을 복사하여 사용(공유 X)
• int, double, Integer, String 등

기본값 타입 예시

@Entity
public class Member extends BaseEntity {
    @Id
    @GeneratedValue
    private Long id; // 기본값 타입

    private String name; // 기본값 타입
}

 

b.임베디드 타입(embedded type)

• 복합값 타입으로, 공통으로 사용되는 값들을 직접 정의하여 사용한다. 
• @Embeddable 어노테이션을 사용하여 임베디트 타입을 정의하며, 엔티티 필드에 포함될 때는 @Embedded 어노테이션을 사용한다.
• 임베디드 타입의 클래스는 기본 생성자가 필수이다.
• 주소, 날짜 정보 등

임베디드 타입 예시

@Entity
public class Member {
    @Id
    @GeneratedValue
    private Long id;

    private String name;

    @Embedded
    private Address address; // 임베디드 타입
}

@Embeddable // 임베디드 타입 정의
public class Address {
    @Column(length = 10) private String city;
    @Column(length = 20) private String street;
    @Column(length = 5) private String zipcode;
}

 

DDL 결과

 

임베디드 타입을 사용하면서 발생할 수 있는 문제

임베디드 타입은 객체이므로 공유가 가능하다. JPA에서 값 타입을 사용할 때 공유를 하면 예상치 못한 문제가 발생할 수 있다.

 

예제를 보자.

 

member1과 meber2과 하나의 Address의 인스턴스를 공유한다.

member1의 address 속성을 변경시켜 보았다.

실행결과를 보면 member1의 address를 변경했는데 같은 address를 공유하고 있는 member2의 address의 속성도 바뀐 것을 확인할 수 있다.

 

이러한 이유로 JPA 값타입을 사용할 때 공유 객체를 사용하면 안된다.

임베디드 타입을 정의 할 때 불변 객체를 사용하도록 하자.

Address address = new Address("city", "street", "100");

Member member1 = new Member();
member1.setUsername("hello");
member1.setHomeAddress(address);

Member member2 = new Member();
member2.setUsername("hello1");
member2.setHomeAddress(address);

member1.getHomeAddress().setCity("new city"); // member1의 주소를 변경
em.persist(member1);
em.persist(member2);
            
em.flush();
em.clear(); // 영속성 컨텍스트 클리어 

Member findMember1 = em.find(Member.class, member1.getId());
Member findMember2 = em.find(Member.class, member2.getId());

System.out.println("member1 city: " + findMember1.getHomeAddress().getCity());
System.out.println("member2 city: " + findMember2.getHomeAddress().getCity());

// 실행결과
member1 city: new city
member2 city: new city

 

엔티티 내에 같은 2개 이상의 임베디드 타입을 사용하는 경우

• 엔티티 내에 동일한 임베디드 타입의 필드를 사용할 때는 컬럼명이 중복되기 때문에 속성을 재정의 해야한다.
• @AttributeOverrides, @AttributeOverride 어노테이션을 사용하여 속성을 재정의할 수 있다.

@Entity
public class Member {
    @Id
    @GeneratedValue
    private Long id;

    private String name;

    @Embedded
    @AttributeOverrides({
            @AttributeOverride(name = "city", column = @Column(name = "home_city")),
            @AttributeOverride(name = "street", column = @Column(name = "home_street")),
            @AttributeOverride(name = "zipcode", column = @Column(name = "home_zipcode"))
    })
    private Address homeAddress; // 임베디드 타입
    
    @Embedded
    @AttributeOverrides({
            @AttributeOverride(name = "city", column = @Column(name = "work_city")),
            @AttributeOverride(name = "street", column = @Column(name = "work_street")),
            @AttributeOverride(name = "zipcode", column = @Column(name = "work_zipcode"))
    })
    private Address workAddress; // 임베디드 타입
}

@Embeddable // 임베디드 타입 정의
public class Address {
    @Column(length = 10) private String city;
    @Column(length = 20) private String street;
    @Column(length = 5) private String zipcode;
}

 

DDL 결과

 

 

c. 값 타입 컬렉션(value type collection)

• 여러 개의 값 타입을 저장하기 위한 타입이다.
• @ElementCollection, @CollectionTable 어노테이션을 사용하여 정의한다.
• 데이터베이스는 컬렉션 타입의 데이터를 저장할 수 없기 때문에, 별도의 테이블로 매핑된다.
• 기본적으로 지연로딩 전략을 사용한다.
• 엔티티 생명주기에 종속된다. =>  CASECADE.ALL + orphanRemoval = true 와 같은 효과
• 컬렉션 내에 저장되는 타입이 사용자 정의 객체일 경우 equals&hashCode 메서드를 재정의해줘야 한다.
• 주소 이력, 태그 리스트 등

값 타입 컬렉션 예시

@Entity
public class Member {
    @Id
    @GeneratedValue
    private Long id;

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

    @ElementCollection
    @CollectionTable(name = "favorite_food", joinColumns = @JoinColumn(name = "member_id"))
    @Column(name = "food_name")
    private Set<String> favoriteFoods = new HashSet<>(); // 값 타입 컬렉션

    @ElementCollection
    @CollectionTable(name = "address", joinColumns = @JoinColumn(name = "member_id"))
    private List<Address> addressHisotry = new ArrayList<>(); // 값 타입 컬렉션
}

@Embeddable
public class Address {
    private String city;
    private String street;
    private String zipcode;

    protected Address() {}

    public Address(String city, String street, String zipcode) {
        this.city = city;
        this.street = street;
        this.zipcode = zipcode;
    }

    @Override
    public boolean equals(Object object) {
        if (this == object) return true;
        if (object == null || getClass() != object.getClass()) return false;
        Address address = (Address) object;
        return Objects.equals(getCity(), address.getCity()) && Objects.equals(getStreet(), address.getStreet()) && Objects.equals(getZipcode(), address.getZipcode());
    }

    @Override
    public int hashCode() {
        return Objects.hash(getCity(), getStreet(), getZipcode());
    }
}

 

DDL 결과

 

값 타입 컬렉션의 제약사항

엔티티와 다르게 식별자 개념이 없고 모든 컬럼을 묶어 키를 구성해야하므로 null과 중복 저장이 안된다. 

또한, 값 타입 컬렉션에 변경 사항이 발생하면, 주인 엔티티와 연관된 모든 데이터를 삭제하고, 값 타입 컬렉션에 있는 데이터를 다시 저장한다.

 

이러한 문제로 인해 실무에서는 값 타입 컬렉션을 잘사용하지 않으며, 1:N 관계로 대체하는 것이 바람직하다.