[JPA] JPA가 지원하는 컬렉션

컬렉션

JPA에서는 자바에서 기본적으로 제공하는 Collection, List, Set, Map 컬렉션을 지원하고 다음 경우에 이 컬렉션을 사용할 수 있다. 

• @OneToMany, @ManyToMany 를 사용해서 '일대다' 혹은 '다대다' 엔티티 관계를 매핑할 때.
• @ElementCollection을 사용해서 값 타입을 하나 이상 보관할 때

 

우선 자바 컬렉션 인터페이스의 특징을 간단히 살펴보고 가자.

 

---

 

자바 컬렉션 인터페이스의 특징

 

• Collection : 자바가 제공하는 최상위 컬렉션이다. 
• List : 순서가 있고, 중복을 허용한다.
• Set : 순서가 없고, 중복은 허용하지 않는다
• Map : Key, Value로 되어있으며 키는 중복을 불허한다.

 

 

---

 

JPA와 컬렉션

JPA 명세에는 자바 컬렉션 인터페이스에 대한 특별한 언급이 없다. 따라서 JPA 구현체에 따라서 제공하는 기능이 조금씩 다를 수 있다. 여기서는 하이버네이트 구현체를 기준으로 이야기한다. 

 

하이버네이트는 엔티티를 영속 상태로 만들 때, 컬렉션 필드를 하이버네이트에서 준비한 컬렉션으로 감싸서 사용한다.

컬렉션을 효율적으로 관리하기 위해서이며, 이런 특징 때문에 컬렉션을 사용할 때 다음처럼 즉시 초기화해서 사용하는 것을 권장한다.

Collection<Member> members = new ArrayList<Member>();

 

컬렉션의 종류에 따라 사용되는 래퍼 클래스가 다른데 알아보자.

 

컬렉션 인터페이스	내장 컬렉션	중복 허용	순서 보관
Collection, List	PersistentBag	O	X
Set	PersistentSet	X	X
List + @OrderColumn	PersistentList	O	O

 

---

Collection, List - PersistentBag

Collection, List 인터페이스는 중복을 허용하는 컬렉션이고, PersistentBag을 래퍼 컬렉션으로 사용한다. 이 인터페이스는 ArrayList로 초기화하여 사용하면 된다.

contains() 혹은 remove() 등의 같은 엔티티를 찾거나 삭제할 때는 equals() 메소드를 사용한다.

 

Collection, List는 엔티티를 추가할 때 중복된 엔티티가 있는지 비교하지 않고 단순히 저장하기 때문에, 엔티티를 저장해도 지연 로딩된 컬렉션을 초기화하지 않으니 주의하자!

 

 

---

 

Set - PersistentSet

Set은 중복을 허용하지 않는 컬렉션으로, 하이버네이트에서는 PersistentSet을 컬렉션 래퍼로 사용한다. 이 인터페이스는 HashSet으로 초기화하면 된다. (반드시 HashSet일 필요는 없고 단지 예시이다.)

 

HashSet은 중복을 허용하지 않으므로, add() 메소드로 객체를 추가할 때 마다 equals() 메소드로 같은 객체가 있는지 비교한다. 같은 객체가 없다면 객체를 추가하고, 있다면 false를 반환하며 추가하지 않는다.

참고로 HashSet은 해시 알고리즘을 사용하므로 hashcode()도 함께 사용해서 비교한다.

 

Set은 엔티티를 추가할 때 중복된 엔티티가 있는지 비교해야 한다. 따라서 엔티티를 추가할 때 지연 로딩된 컬렉션을 초기화한다.

 

---

 

List + @OrderColumn - PersistentList

JPA에서는 List는 순서를 보장해주지 않았다. 그러나 @OrderColumn을 추가하면 순서가 있는 특수한 컬렉션으로 인식한다. 순서가 있다는 의미는 데이터베이스에 순서 값을 저장해서 조회할 때 사용한다는 의미이다.

이 경우 하이버네이트는 내부 컬렉션인 PersistentList를 사용한다.

@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@Entity
public class Member {

    @Id @GeneratedValue
    @Column(name = "MEMBER_ID")
    private Long id;

    private String name;

    @Embedded
    private Address address;

    @OneToMany(mappedBy = "member")
    @OrderColumn(name = "ORDERS_ORDER_NUMBER")
    private List<Order> orders = new ArrayList<>();


}

 

 

다음과 같이 @OrderColumn을 추가해주면 Order 테이블에 다음과 같이 순서 컬럼이 생긴다.

 

 

순서는 0부터 시작한다.

 

@OrderColumn을 사용해서 List의 위치 값을 보관하면 편리할 거 같지만 단점이 좀 많아 실제로는 잘 사용하지 않는다.

따라서 @OrderColumn을 매핑하지 말고 개발자가 직접 순서값을 관리하거나 다음에 설명하는 @OrderBy를 사용하길 권장한다.

 

 

OrderColumn의 단점

• @OrderColumn은 대상 엔티티에서 매핑하므로, 주인 엔티티가 순서의 값을 알 수 없다. 그래서 주인 엔티티를 INSERT 할 때는 순서의 값이 저장되지 않는다. 대상 엔티티의 값을 UPADTE하는 SQL이 추가로 발생한다.
• List를 변경하면 연관된 많은 위치 값을 변경해야 한다. 예를 들어 Order이 4개 있었을 때, 첫번째 Order을 삭제하면, Order2, Order3, Order4의 순서를 각각 하나씩 줄이는 UPDATE SQL이 총 3번 발생한다.
• 중간에 순서 값이 없으면 조회한 List에는 null이 보관된다. 따라서 컬렉션을 순회할때 NFE가 발생한다.

 

---

 

@OrderBy

사용법은 아래 포스팅을 참고하자.

[JPA] @OrderBy - 리스트에 순서 지정하기

 

 

 

📔 Reference

[자바 ORM 표준 JPA 프로그래밍]