JPA 연관관계 영속성 전이(CASCADE)

📎 JPA 영속성 전이(CASCADE)

안녕하세요! 이번에 정리할 내용은 JPA에서 영속성 전이(CASCADE)와 관련된 내용입니다.

최근 개발을 진행하며 두 연관된 엔티티에서 save()를 하는 과정에서 오류가 발생했고,

이를 해결하는 과정에서 영속성 전이(CASCADE)라는 개념에 대해 알게 되었고, 이를 정리하고자 합니다. 😊

(※ 잘못된 내용이 포함되어 있을수도 있습니다. 잘못된 부분에 대해 지적해주시면 감사하겠습니다 😂)

🎯 영속성전이(CASCADE)란 ?

부모 엔티티가 영속화될 때 자식 엔티티도 같이 영속화되고, 부모 엔티티가 삭제될 때 자식 엔티티도 삭제되는 등 특정 엔티티를 영속 상태로 만들 때 연관된 엔티티도 함께 영속 상태로 전이되는 것을 의미합니다.

https://www.baeldung.com/jpa-cascade-types

즉, 특정 엔티티에 대해 특정한 작업을 수행하면 관련된 엔티티에도 동일한 작업을 수행한다는 의미입니다.

~~(해석 맞나요? ㅎㅎ;)~~

JPA에서는 이러한 연관된 엔티티간의 의존성(dependency)을 설정하기 위해 Enum 타입의 javax.persistence.CascadeType 을 제공하고 있습니다.

/*
 * Copyright (c) 2008, 2019 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0,
 * or the Eclipse Distribution License v. 1.0 which is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause
 */

// Contributors:
//     Linda DeMichiel - 2.1
//     Linda DeMichiel - 2.0

package javax.persistence;

/**
 * Defines the set of cascadable operations that are propagated 
 * to the associated entity.
 * The value <code>cascade=ALL</code> is equivalent to 
 * <code>cascade={PERSIST, MERGE, REMOVE, REFRESH, DETACH}</code>.
 *
 * @since 1.0
 */
public enum CascadeType { 

    /** Cascade all operations */
    ALL, 

    /** Cascade persist operation */
    PERSIST, 

    /** Cascade merge operation */
    MERGE, 

    /** Cascade remove operation */
    REMOVE,

    /** Cascade refresh operation */
    REFRESH,

    /**
     * Cascade detach operation
     *
     * @since 2.0
     * 
     */   
    DETACH
}

CascadeType는 코드와 같이 PERSIST, MERGE, DETACH, PREFRESH, REMOVE, ALL 로 구성되어 있습니다.

각각의 operations에 대한 설명은 다음과 같습니다.

CascadeType.ALL: 모든 Cascade를 적용
CascadeType.PERSIST: 엔티티를 영속화할 때, 연관된 엔티티도 함께 유지
CascadeType.MERGE: 엔티티 상태를 병합(Merge)할 때, 연관된 엔티티도 모두 병합
CascadeType.REMOVE: 엔티티를 제거할 때, 연관된 엔티티도 모두 제거
CascadeType.DETACH: 부모 엔티티를 detach() 수행하면, 연관 엔티티도 detach()상태가 되어 변경 사항 반영 X
CascadeType.REFRESH: 상위 엔티티를 새로고침(Refresh)할 때, 연관된 엔티티도 모두 새로고침

🤔 문제 상황

서론에서 언급했듯이, 연관되어 있는 두 엔티티에서 save()를 진행하는 과정에서 오류가 발생했습니다.

현재 연관된 엔티티의 코드는 다음과 같습니다.

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.persistence.CascadeType;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.FetchType;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.ManyToOne;

@Entity
@Getter
@ToString(exclude = "member")
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Board extends BaseEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long bno;

    @Column
    private String title;

    @Column
    private String content;

    @ManyToOne(fetch = FetchType.LAZY)
    private Member member;

    public void changeTitle(String title) {
        this.title = title;
    }

    public void changeContent(String content) {
        this.content = content;
    }
}



import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;

@Entity
@Getter
@ToString
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Member extends BaseEntity {

    @Id
    private String email;

    @Column
    private String password;

    @Column
    private String name;
}

Board(게시글) 과 Member(회원) 은 N:1의 관계를 가지고 있습니다.

또한 Board에서 @ManyToOne 어노테이션을 통해 Member 엔티티를 가지고 있습니다.

위 두 엔티티를 통해 save()를 하는 코드는 다음과 같습니다.

    @Test
    @DisplayName("연관관계를 가진 두 엔티티에 CASCADE 속성을 설정하지 않으면 예외가 발생한다.")
    void insertBoard() {
        IntStream.rangeClosed(301, 350)
                .forEach(i -> {
                    Member member = Member.builder().email("user" + i + "@aaa.com").build();
                    Board board = Board.builder()
                            .title("Title..." + i)
                            .content("Content..." + i)
                            .member(member)
                            .build();

                    boardRepository.save(board);
                });
    }

위 테스트코드를 실행하면 다음과 같은 에러가 발생합니다.

Caused by: java.lang.IllegalStateException: org.hibernate.TransientPropertyValueException: object references an unsaved transient instance - save the transient instance before flushing ...

Caused by: org.hibernate.TransientPropertyValueException: object references an unsaved transient instance - save the transient instance before flushing ...

https://docs.jboss.org/hibernate/orm/5.1/javadocs/org/hibernate/TransientPropertyValueException.html

TransientPropertyValueException 클래스에 대한 설명입니다.

대략적인 의미는 일시적으로 저장되지 않은 엔티티와의 관계로 인해 persist(영속화) 할 수 없을때 예외를 던진다고 설명하고 있습니다.

🤔 해결 방법

따라서 엔티티의 연관관계에 CASCADE 설정을 해주어야 합니다.(CascadeType)

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.persistence.CascadeType;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.FetchType;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.ManyToOne;

@Entity
@Getter
@ToString(exclude = "member")
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Board extends BaseEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long bno;

    @Column
    private String title;

    @Column
    private String content;

    // 영속성 전이(Cascade)
    @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.PERSIST)
    private Member member;

    public void changeTitle(String title) {
        this.title = title;
    }

    public void changeContent(String content) {
        this.content = content;
    }
}

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;

@Entity
@Getter
@ToString
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Member extends BaseEntity {

    @Id
    private String email;

    @Column
    private String password;

    @Column
    private String name;
}

현재 제 코드에서는 Board 엔티티만 Member 엔티티를 가지고 있습니다.

따라서 Board의 @ManyToOne 어노테이션에 영속성 전이 설정(CascadeType.PERSIST)을 추가합니다.

그 후 테스트코드를 다시 실행해보면 정상적으로 작동이 됩니다.

    @Test
    @DisplayName("연관관계를 가진 두 엔티티에 CASCADE 속성을 설정하면 정상적으로 save()메소드가 수행된다.")
    void insertBoard() {
        IntStream.rangeClosed(351, 400)
                .forEach(i -> {
                    Member member = Member.builder().email("user" + i + "@aaa.com").build();
                    Board board = Board.builder()
                            .title("Title..." + i)
                            .content("Content..." + i)
                            .member(member)
                            .build();

                    boardRepository.save(board);
                });
    }

Preferences

저작자표시

'Spring > Spring Data JPA' 카테고리의 다른 글

JPQL @Query 에러: For queries with named parameters you need to use provide names for method parameters (6)	2021.07.06
Spring Data JPA 즉시 로딩(Eager Loading) & 지연 로딩(Lazy Loading) (0)	2021.06.17

문의사항은 zzang9ha@naver.com 로 주세요 :)

JPA 연관관계 영속성 전이(CASCADE) - CascadeType

📎 JPA 영속성 전이(CASCADE)

🎯 영속성전이(CASCADE)란 ?

🤔 문제 상황

🤔 해결 방법

Preferences

'Spring > Spring Data JPA' 카테고리의 다른 글

댓글

티스토리툴바

JPA 연관관계 영속성 전이(CASCADE) - CascadeType

📎 JPA 영속성 전이(CASCADE)

🎯 영속성전이(CASCADE)란 ?

🤔 문제 상황

🤔 해결 방법

Preferences

'Spring > Spring Data JPA' 카테고리의 다른 글

관련글

댓글

티스토리툴바