[JPA] EntityManager 핵심 기능

🌱 Entity의 상태 (생명 주기)

JPA에서 엔티티는 크게 4가지 상태를 가지며, 상태를 전환시키는 기능을 EntityManager가 제공한다.

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

2. Persistent(영속): 엔티티 객체가 영속성 컨텍스트에 관리된 상태(영속 상태라고 바로 DB에 쿼리가 날라가는 것 X)

3. Detached(준영속): 엔티티 객체가 영속성 컨텍스트에 저장되었다가 분리된 상태

4. Removed(삭제): 실제 DB 삭제를 요청한 상태

 

🌱 Hibernate JPA EntityManager 핵심 기능

1️⃣ Persist

persist는 엔티티의 새로운 인스턴스를 영속성 컨텍스트에 저장할 때 사용된다.

Person person = new Person(name); // Transient/New
em.persist(person);   // Managed

처음 엔티티 객체 생성 시 해당 객체는 Transiend/New 상태로 불린다.

persist 없이 바로 Transaction을 종료하면 데이터베이스상에는 아무 변화도 일어나지 않는다.

 

이 엔티티를 영속성 컨텍스트가 관리하도록 하기 위해서는 persist 메서드를 호출해야 하며, 해당 메서드 호출 뒤 persion은 Managed 상태가 된다.

 

이런 Managed 상태의 엔티티들은 EntityManager에 의해 Dirty Check(변경 감지)가 되어 영속성 컨텍스트 내의 내용을 데이터베이스에 반영하는 flush 메서드가 호출되었을 때, 변경된 필드에 대해 자동으로 update/insert문이 발행된다.

 

2️⃣ Detach

entityManager.detach(person);
person.setName(anotherName); // will not saved automatically

엔티티가 Managed인 상태에서 detach 메서드 호출 시 해당 엔티티는 Detached 상태가 되어 더 이상 영속성 컨텍스트에 의해 관리를 받지 않게 된다. 따라서, 트랜잭션이 종료되더라도 detach 된 엔티티에 대한 자동적인 생성/수정 작업은 전혀 일어나지 않게 된다.

 

Person person = entityManager.find(Person.class, 1L);
entityManager.detach(person);

영속성 컨텍스트에서 id가 1L인 엔티티가 있고 이를 find로 찾아온 경우, 이 객체는 영속성 컨텍스트에 의해 관리되는 중이므로, Managed 상태이다.

하지만 detach 메서드로 영속성 컨텍스트와 관계를 끊으면 해당 persion 객체는 Detached 상태가 된다.

(Detached 되어도, 트랜잭션이 종료될 때 영속성 컨텍스트 내에 있던 내용은 데이터베이스에 정상적으로 반영된다.)

 

detach는 영속성 컨텍스트나 데이터베이스에는 전혀 영향을 주지 않고, 어떤 엔티티 인스턴스를 '오프라인' 상태로 만든다고 볼 수 있다.(영속성 컨텍스트에는 여전히 온라인 상태의 엔티티 존재)

 

3️⃣ Merge

merge는 영속성 컨텍스트에 있는 엔티티의 상태를 분리되어 있는 엔티티 인스턴스의 새 필드 값으로 업데이트할 때 사용된다.

Person person = new Person(id, content);
entityManager.merge(person);

merge는 다음과 같은 작업을 수행한다.

- merge() 실행

- 파라미터로 넘어온 준영속 엔티티의 ID 값으로 1차 캐시에서 엔티티 조회
   → 1차 캐시에 엔티티가 없으면 데이터베이스에서 엔티티를 조회하고 1차 캐시에 저장

- 조회한 영속 엔티티(mergePerson)에 person 엔티티의 값 채워 넣음

- 영속 상태인 mergePerson 반환

 

persist()는 return 값이 없지만, 전달된 인스턴스가 managed 된다.

merge()는 전달된 인스턴스가 여전히 Detached 상태인 대신 Managed 상태인 인스턴스를 return 한다.

따라서 merge()를 호출하는 경우 반드시 리턴된 결과를 통해 다음 작업을 진행해야 entityManager가 관리하는 상태를 추적할 수 있다.

 

4️⃣ Remove

remove는 데이터베이스에서 엔티티가 삭제되기를 원할 때 사용된다.

em.remove(comment); // will removed from db

이 경우 영속성 컨텍스트에서 제거되고 트랜잭션이 종료될 때 데이터베이스에서 삭제도 된다.

 

 

 

Hibernate JPA EntityManager 핵심 기능 정리

JPA EntityManager: Why use persist() over merge()?