[JPA] 필드와 컬럼 매핑 - @ElementCollection (값 타입 컬렉션 매핑), @CollectionTable

 

 

 

 

 

 

 

🧐 값 타입 컬렉션

값 타입을 컬렉션에 담아서 사용할 때, 해당 컬렉션을 값 타입 컬렉션이라 합니다.

(@OneToMany 처럼 엔티티를 컬렉션으로 사용하는 것이 아닌, Integer, String, 임베디드 타입 같은 값 타입을 컬렉션으로 사용하는 것입니다.)

 

 

관계형 데이터베이스는 컬렉션을 담을 수 있는 구조가 없습니다.

따라서 이를 저장하기 위해서는 별도의 테이블을 만들어서 저장해야 합니다.

 

이때 값 타입 컬렉션은 개념적으로 보면 1대 N 관계입니다.

(그리고 값 타입을 저장하는 테이블은 값 타입을 소유한 엔티티의 기본 키와 모든 값 타입 필드를 묶어서 PK로 사용하며,

엔티티의 기본 키를 PK겸 FK로 사용합니다.)

 

 

 

 

 

 

 

 

 

🧐 @ElementCollection

값 타입 컬렉션을 매핑할 때 사용합니다.

 

RDB에는 컬렉션과 같은 형태의 데이터를 컬럼에 저장할 수 없기 때문에, 별도의 테이블을 생성하여 컬렉션을 관리해야 합니다.

이때 해당 필드가 컬렉션 객체임을 JPA에게 알려주는 어노테이션이 @ElementCollection 입니다.

 

@Entity가 아닌 Basic Type이나 Embeddable Class로 정의된 컬렉션을 테이블로 생성하며 One-To-Many 관계로 다룹니다.

 

 

 

 

 

 

 

 

 

 

 

 

🧐 @CollectionTable

@ElementCollection은 @CollectionTable과 함께 사용합니다.

 

@CollectionTable은 값 타입 컬렉션을 매핑할 테이블에 대한 정보를 지정하는 역할을 수행합니다.

 

만약 이를 생략한다면 기본값을 이용하여 매핑합니다.

기본값 : {엔티티이름}_{컬렉션 필드 이름}

@Entity
public class StudyGroup {
    @Id 
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
 
    // Basic type
    @ElementCollection(fetch = FetchType.LAZY)
    @Column(name = "TOPIC_NAME")//String인 경우에 한해서 예외적으로 허용, 이외 타입은 @AttributeOverride를 사용해서 테이블 속성을 재정의한다.
    private Set<String> topicTags = new HashSet<String>();
 
    // Embedded type
    @ElementCollection
    @CollectionTable(name="study_group_member", joinColumns = @JoinColumn(name= "study_group_id", referencedColumnName = "id"))
    private Set<StudyGroupMember> members = new HashSet<StudyGroupMember>();
}

@Embeddable
public class StudyGroupMember {
    private UUID memberId;
    private Boolean isOwner;
}

 

생성되는 테이블은 다음과 같습니다.

 

 

 

 

참고

• 값 타입 컬렉션은 조회 시 지연로딩 전략을 사용합니다.
• 값 타입의 생명주기는 부모 엔티티에 의해 관리됩니다. 즉 영속성 전이(Cascade ALL) + 고아 객체 제거 기능을 필수로 가진다고 볼 수 있습니다.

 

 

 

 

 

 

 

 

 

 

🧐 주의

⭐️ 값 타입 컬렉션의 제약

• 값 타입은 엔티티와 다르게 식별자 개념이 없기 때문에 값을 변경하면 추적이 어렵습니다.
• 값 타입 컬렉션에 변경 사항(저장, 삭제)이 발생하면, 소유하는 엔티티와 연관된 모든 데이터를 삭제하고, 현재 남아있는 값을 모두 다시 저장합니다.(예제에서는 삭제를 예로 들었지만, 저장도 마찬가지입니다.)
• 값 타입 컬렉션을 매핑하는 테이블은 모든 컬럼을 묶어서 기본키를 구성해야 합니다. -> null 입력 X, 중복 저장 X

 

 

 

 

 

⭐️ 값 타입 컬렉션의 대안

값 타입 컬랙션 대신에 일대다 관계를 고려하는 것이 좋습니다.

• 일대다 엔티티를 만들고, 엔티티에서 값 타입을 사용합니다.
• cascade와 고아 객체 제거를 설정해서 값 타입 컬렉션처럼 사용할 수 있습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 @ElementCollection과  @OneToMany의 차이

 

 

⭐️ @ElementCollection

• 연관된 부모 Entity 하나에만 연관되어 관리됩니다. (부모 Entity와 독립적으로 사용이 불가능합니다.)
• 항상 부모와 함께 저장되고 삭제되므로 cascade 옵션은 제공하지 않습니다. (cascade = ALL 인 셈입니다.)
• 부모 Entity Id와 추가 컬럼(basic or embedded 타입)으로 구성됩니다.
• 기본적으로 식별자 개념이 없으므로 컬렉션 값 변경 시, 전체 삭제 후 새로 추가합니다.

 

 

 

 

 

 

 

 

⭐️ @OneToMany / @ManyToMany

• 다른 Entity에 의해 관리될 수도 있습니다.
• join table이나 컬럼은 보통 ID만으로 연관을 맺습니다.

 

 

 

 

 

 

 

 

 

 

Reference

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

[자바 ORM 표준 JPA 프로그래밍 - 김영한]

 

[JPA] 값 타입 컬렉션 : @ElementCollection, @CollectionTable

JPA @ElementCollection