JPA 엔티티 상태 (생명주기)

JPA의 엔티티 상태

• Transient: 엔티티가 영속성 컨텍스트에 관리되지 않는 상태이다. 새로운 엔티티 객체를 생성하지만 아직 영속성 컨텍스트에 추가되지 않았다.

User user = new User();
user.setName("John Doe");
// user는 transient 상태

• Persistent: 엔티티가 영속성 컨텍스트에 의해 관리되는 상태이다. 이 상태에서는 엔티티의 변경 사항이 영속성 컨텍스트에 의해 추적되고, 트랜잭션이 커밋될 때 데이터베이스에 반영된다.

entityManager.persist(user);
// user는 persistent 상태

• Detached: 엔티티가 영속성 컨텍스트에 의해 더 이상 관리되지 않는 상태이다. 주로 트랜잭션이 종료되거나 엔티티 매니저가 닫힐 때 발생한다.

entityManager.detach(user);
// user는 detached 상태

• Removed: 엔티티가 삭제되기로 표시된 상태이다. remove 메서드를 호출하여 엔티티를 제거한다. 트랜잭션이 커밋될 때 데이터베이스에서 삭제된다.

entityManager.remove(user);
// user는 removed 상태

예시

엔티티 클래스

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "user_name", nullable = false)
    private String name;
    
    private int age;

    // getters and setters
}

영속성 컨텍스트 사용 예시

public class JpaMain {
    public static void main(String[] args) {
        // 아직까지는 해당 엔티티를 엔티티 매니저가 관리하지 않는다.
        User user = new User();
        user.setName("John Park");
        user.setAge(30);
        
        //META-INF/persistence.xml에서 이름이 db인 persistence-unit을 찾아서 엔티티 매니저 팩토리를 생성 
        EntityManagerFatory emf = Persistence.createEntityManagerFactory("db");
        EntityManager em = emf.createEntityManager();
        EntityTransaction tx = em.getTransaction();
        
        try {
            // 엔티티 매니저에서 수행하는 모든 로직은 트랜잭선 안에서 수행돼야 한다.
            tx.begin();
            
            // 이렇게 하면 해당 엔티티 매니저의 영속성 컨텍스트에 위에서 만든 User 객체가 저장된다.  
            // 이제 user 엔티티는 엔티티 매니저의 관리 대상이 되고, 영속성을 가졌다고 말할 수 있다.
            em.persist(user);
            
            // 상태 변경 감지 (Dirty Checking)
            user.setName("Jane Park");
 
               // Detached 상태
            em.detach(user);
 
            // 다시 Persistent 상태로 변경
            em.merge(user);
            
            // 트랜잭션을 커밋한다. DB로 flush가 일어나면서 DB에 데이터가 영속된다.
            tx.commit();
        } catch(Exception e) {
            // 어떤 이유에서 오류가 났다면 트랜잭션을 롤백 시켜줘야한다.
            tx.rollback();
        } finally {
            // 엔티티 매니저를 종료시켜줘야 한다.  
            em.close();
        }
        emf.close(); // 마찬가지로 엔티티 매니저 팩토리도 더이상 쓰지 않는다면 종료시켜줘야 한다.
    }
}

 

요약

• 영속성 컨텍스트(Persistence Context): 엔티티 매니저가 관리하는 엔티티 인스턴스들의 집합으로, 엔티티의 생명주기를 관리하고 1차 캐시 및 변경 감지 기능을 제공한다.
• 엔티티 상태: Transient(영속성 컨텍스트에 관리되지 않는 상태), Persistent(영속성 컨텍스트에 의해 관리되는 상태), Detached(영속성 컨텍스트에 의해 더 이상 관리되지 않는 상태), Removed(삭제된 상태)로 구분된다.

참고

인프런 - 자바 ORM 표준 JPA 프로그래밍 - 기본편 / 김영한