[JPA] Cascade 영속성 전이

🌱 Entity의 상태 (생명 주기)

JPA에서 엔티티는 크게 4가지 상태를 가진다.

 

1. Transient (비영속)

엔티티 객체가 Java 메모리에서만 존재하고, 영속성 컨텍스트와 아무 관련 없는 상태

Person person = new Person();

 

2. Persistent (영속)

엔티티 객체가 영속성 컨텍스트에 관리된 상태

영속 상태라고 바로 데이터베이스에 쿼리가 날라가는 것은 아니고 주로 트랜잭션이 commit 되거나  flush 메서드 실행 시 데이터베이스에 반영 된다.

entityManger.persist(person);

 

3. Detached (준영속)

엔티티 객체가 영속성 컨텍스트에 저장되었다가 분리된 상태

더이상 영속성 컨텍스트에 의해 관리되지 않기 때문에 1차 캐시 등에서 모든 정보가 삭제된다.

entityManger.detach(person);

 

4. Removed (삭제)

엔티티를 영속성 컨텍스트와 데이터베이스에서 삭제한 상태

entityManger.remove(person);

 

Cascade 옵션은 이러한 상태 변화를 연관된 엔티티에 전이시키는 옵션이다.

 

🌱 Cascade 란?

Cascade는 JPA(Java Persistence API)에서 연관관계를 가진 엔티티의 생명 주기를 관리하기 위해 사용되는 설정이다.

이 옵션을 설정하면 부모 엔티티의 상태 변경이나 삭제가 자식 엔티티에게도 영향을 미치게 된다.

 

리뷰(Review)와 리뷰 이미지(ReviewImage)를 예시로 들어보면

@Entity
public class Review {

    @Id
    @GeneratedValue
    private Long id;
    
    private String content;
    
    @OneToMany(mappedBy = "review")
    private List<ReviewImage> reviewImages = new ArrayList<>();
    
    // constructor, getter, setter, ...
}

@Entity
public class ReviewImage {

    @Id
    @GeneratedValue
    private Long id;

    private String imageUrl;

    @ManyToOne
    @JoinColumn(name = "review_id")
    private Review review;
    
    // constructor, getter, setter, ...
}

@Test
public void no_cascade() {

    Review review = new Review();
    review.setContent("리뷰 내용");
    
    ReviewImage reviewImage1 = new ReviewImage();
    reviewImage1.setImageUrl("리뷰이미지1 url");
    ReviewImage reviewImage2 = new ReviewImage();
    reviewImage2.setImageUrl("리뷰이미지2 url");
    
    review.getReviewImageList().add(reviewImage1);
    review.getReviewImageList().add(reviewImage2);
    
    // 영속화 작업 수행
    entityManager.persist(review);
    entityManager.persist(reviewImage1);
    entityManager.persist(reviewImage2);
}

Review 엔티티와 ReviewImage 엔티티는 양방향 연관관계가 맺어져있다.

마지막 테스트 코드에서 만든 [review, reviewImage1, reviewImage2] 세 인스턴스를 영속화하기 위해서는 entityManager.persist 메서드를 3번 호출해 Review와 ReviewImage를 각각 영속화 시켜주는 작업을 진행해야 한다.

 

여기서 Review과 관리하는 ReviewImage 인스턴스의 경우 Review를 persist 하면 ReviewImage 자동으로 persist 해줄 수 있는 옵션이 Cascade이다.

 

🌱 Cascade 옵션

- PERSIST

- MERGE

- REMOVE

- REFRESH

- DETATCH

- ALL

 

리뷰(Review)와 리뷰 이미지(ReviewImage)를 예시로 들어보면

@Entity
public class Review {

    @Id
    @GeneratedValue
    private Long id;
    
    private String content;
    
    @OneToMany(mappedBy = "review")
    private List<ReviewImage> reviewImages = new ArrayList<>();
    
    // constructor, getter, setter, ...
}

@Entity
public class ReviewImage {

    @Id
    @GeneratedValue
    private Long id;

    private String imageUrl;

    @ManyToOne
    @JoinColumn(name = "review_id")
    private Review review;
    
    // constructor, getter, setter, ...
}

 

🫧 CascadeType.PERSIST

하위 엔티티까지 영속성을 전달한다.

Review 엔티티를 저장하면 하위 엔티티인 ReviewImage 엔티티도 영속성 컨텍스트에 저장한다.

@Test
public void persist_test() {

    Review review = new Review();
    review.setContent("리뷰 내용");
    
    ReviewImage reviewImage1 = new ReviewImage();
    reviewImage1.setImageUrl("리뷰이미지1 url");
    ReviewImage reviewImage2 = new ReviewImage();
    reviewImage2.setImageUrl("리뷰이미지2 url");
    
    review.getReviewImageList().add(reviewImage1);
    review.getReviewImageList().add(reviewImage2);
    
    // 영속화 작업 수행
    entityManager.persist(review);
    entityManager.flush();
}

review 엔티티를 영속화하면 PERSIST 옵션으로 인해 [reviewImage1, reviewImage2]도 영속화 된다.

 

🫧 CascadeType.MERGE

하위 엔티티까지 병합 작업을 지속한다.

Review 엔티티와 ReviewImage 엔티티를 조회해와 수정한 후 Review 엔티티를 Merge하면 하위 엔티티인 ReviewImage 엔티티의 변경 사항도 수정된다.

@Test
public void merge_test() {

    Review review = new Review();
    review.setContent("리뷰 내용");
    
    ReviewImage reviewImage1 = new ReviewImage();
    reviewImage1.setImageUrl("리뷰이미지1 url");
    ReviewImage reviewImage2 = new ReviewImage();
    reviewImage2.setImageUrl("리뷰이미지2 url");
    
    review.getReviewImageList().add(reviewImage1);
    review.getReviewImageList().add(reviewImage2);
    
    // 영속화 작업 수행 및 영속성 컨텍스트 초기화
    entityManager.persist(review);
    entityManager.flush();
    entityManager.clear();
    
    Review savedReview = entityManager.find(0L, Review.class);
    ReviewImage savedReviewImage = entityManager.find(0L, ReviewImage.class);
    
    // 엔티티 수정
    savedReview.setContent("리뷰 내용 수정");
    savedReviewImageUrl.setImageUrl("리뷰이미지1 url 수정");
    
    // merge 작업 수행
    entityManager.merge(savedReview);
    entityManager.flush();
}

review 엔티티 merge 시 MERGE 옵션으로 인해 reviewImage1도 merge 된다.

 

🫧 CascadeType.REMOVE

하위 엔티티까지 삭제 작업을 지속한다.

Review 엔티티를 삭제하면 하위 엔티티인 ReviewImage 엔티티도 삭제된다.

@Test
public void remove_test() {

    Review review = new Review();
    review.setContent("리뷰 내용");
    
    ReviewImage reviewImage1 = new ReviewImage();
    reviewImage1.setImageUrl("리뷰이미지1 url");
    ReviewImage reviewImage2 = new ReviewImage();
    reviewImage2.setImageUrl("리뷰이미지2 url");
    
    review.getReviewImageList().add(reviewImage1);
    review.getReviewImageList().add(reviewImage2);
    
    // 영속화 작업 수행 및 영속성 컨텍스트 초기화
    entityManager.persist(review);
    entityManager.flush();
    entityManager.clear();
    
    Review savedReview = entityManager.find(0L, Review.class);
    
    // remove 작업 수행
    entityManager.remove(savedReview);
    entityManager.flush();
}

review 엔티티 remove 시 REMOVE 옵션으로 인해 [reviewImage1, reviewImage2]도 remove 된다.

 

🫧 CascadeType.REFRESH

영속된 상태에서 조회한 엔티티가 변경되더라도, refresh() 해서 데이터베이스에 저장된 값을 override 하고, 자식 엔티티도 refresh 한다.

→ 영속성 컨텍스트에 저장된 값 새로고침

Review 엔티티를 Refresh하면 하위 엔티티인 ReviewImage 엔티티도 Refresh된다.

 

🫧 CascadeType.DETACH

영속성 컨텍스트에서 더이상 해당 엔티티를 관리하지 않는 준영속 상태로 만든다.

Review 엔티티를 Detach하면 하위 엔티티인 ReviewImage 엔티티도 Detach된다.

 

🫧 CascadeType.ALL

위의 옵션들이 모두 적용된 상태로, 상위 엔티티의 모든 상태 변화 작업이 하위 엔티티에 전파된다.

 

 

 

JPA Cascade Type : PERSIST vs MERGE (Why choose what?)

[jpa] CascadeType.PERSIST를 함부로 사용하면 안되는 이유

<JPA> 알고 쓰는 Cascade(영속성 전이)

JPA cascade 멈춰!