[TIL] JPA @OneToMany 컬렉션 수정 시 주의점 (컬렉션 추적)

 

 

 

 

 

JPA 엔티티에서 `@OneToMany` 컬렉션을 업데이트할 때, 

리스트를 통째로 교체하면 안 되는 이유에 대해서 정리해 보려고 한다.

 

 

 

🚧 수정 전 코드  - 컬렉션을 새 리스트로 할당

 

//Diary.kt

if (diaryActivityCategoryList.isNotEmpty()) {
    this.diaryActivityCategory?.clear()
    this.diaryActivityCategory = diaryActivityCategoryList
}

 

테스트 과정에서 변경 감지(dirt checking)이 제대로 동작하지 않아 원인을 찾아보았다.

 

 

📌 JPA의 컬렉션 추적 

JPA는 `@OneToMany`로 매핑된 컬렉션을 로딩할 때, 단순한 `ArrayList`가 아닌 Hibernate 전용 래퍼 컬렉션 (`PersistentBag`, `PersistentList` 등)으로 감싸서 관리한다.

 

    @OneToMany(mappedBy = "diary", orphanRemoval = true, cascade = [CascadeType.ALL])
    var diaryActivityCategories: MutableList<DiaryActivityCategory> = mutableListOf()
        protected set

 

 

 

엔티티를 조회하면 `diaryActivityCategories`에는 실제로 `PersistentBag` 타입이 들어가 있다.

이 `PersistentBag`이 내부적으로 원본 스냅샷과 현재 상태를 비교해서 어떤 요소가 추가/삭제되었는지 추적한다.

 

 

 

PersistentBag 🎒

JPA가 관리하는 컬렉션  GPS 추적기가 달린 가방이라고 생각하면 이해하기 쉽다.

 

 

예를들어,

// 방법 1
this.diaryActivityCategory?.clear()
this.diaryActivityCategory?.addAll(diaryActivityCategoryList)

// 방법 2
this.diaryActivityCategory = diaryActivityCategoryList

 

 

방법 1은 JPA가 추적하는 가방은 그대로 두고 내용물만 바꿔주기 때문에, JPA 입장에서 어떤 요소가 추가/삭제 되었는지 추적이 가능하다.

방법 2는 JPA가 추적하던 가방을 버리고 새 가방으로 교체했기 때문에, JPA 입장에서 더이상 추적이 불가능하다.

 

 

 

👷🏻 수정 후 코드 — 같은 컬렉션 유지, 내용만 교체

if (diaryActivityCategoryList.isNotEmpty()) {
    this.diaryActivityCategory.clear()
    this.diaryActivityCategory.addAll(diaryActivityCategoryList)
}

 

JPA가 처음부터 관리하던 컬렉션 객체는 그대로 두고, 안의 요소만 비우고(`clear()`),  다시 요청 값을 추가(`addAll()`)했다.

 

 

 

참고 :

[JPA] 💼 PersistentBag

 

JPA에서 컬렉션과 여러 기능 활용하기