3장 영속성 관리

JPA가 제공하는 기능은 크게 엔티티와 테이블을 매핑하는 설계 부분
매핑한 엔티티를 실제 사용하는 부분으로 나눌 수 잇다.
매핑한 엔티티를 엔티티 매니저(Entity Manager)을 통해 어떻게 사용하는지 알아보자
엔티티 매니저는 엔티티를 저장하고, 수정하고, 삭제하고, 조회하는 등 엔티티와 관련된 모든 일을 처리한다.
엔티티 매니저는 엔티티를 관리하는 관리자다.
엔티티 매니저는 엔티티를 저장하는 가상의 데이터베이스로 생각하면 된다.
참고로 내용중에 구현과 관련된 부분들은 하이버네이트를 기준으로 이야기한다.

3.1 엔티티 매니저 팩토리와 엔티티 매니저

엔티티 매니저 팩토리

데이터 베이스를 하나만 사용하는 애플리 케이션은 이반적으로 EntityManager Factory를 하나만 생성한다.

//엔티티 매니저 팩토리 생성
// p83. JPA를 시작하려면 우선 persistence.xml의 설정 정보를 사용해서 엔티티 매니저 팩토리 생성
// 생성 비용이 크기 때문에 => 프로젝트 전반에 한번만 생성하고 공유해서 사용한다.
EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpabook");
----------------------------------------------------------------------------
persistence.xml 확인  
<?xml version="1.0" encoding="UTF-8"?>
<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence" version="2.1">
            <!-- 필수 속성 -->
            <property name="javax.persistence.jdbc.driver" value="org.h2.Driver"/>
<!--            <property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver"/>-->
            <property name="javax.persistence.jdbc.user" value="sa"/>
<!--            <property name="javax.persistence.jdbc.user" value="root"/>-->
            <property name="javax.persistence.jdbc.password" value=""/>
<!--            <property name="javax.persistence.jdbc.password" value="qkrtmdcks1!"/>-->
            <property name="javax.persistence.jdbc.url" value="jdbc:h2:mem:testdb"/>
<!--            <property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost/study_jpa?characterEncoding=UTF-8"/>-->

엔티티 매니저 팩토리는 이름 그대로 엔티티 매니저를 만드는 공장인데
공장을 만드는 비용은 상당히 크다.
한개만 만들어서 애플리 케이션 전체에서 공유를 하도록 설계되어 있다.
반면에 엔티티 매니저를 생성하는 비용은 거의 들지 않는다.
엔티티 매니저 팩토리는 여러 스레드가 동시에 접근해도 안전하므로 서로 다른 스러드 간에 공유해도되지만

엔티티 매니저

필요할 때마다 엔티티 매니저 팩토리에서 엔티티 매니저를 생성하면 된다.

 // p83. 엔티티 매니저는 등록/수정/삭제/조회를 할수 있다.
 // 엔티티 매니저는 내부에 데이터소스(데이터베이스 커넥션)를 유지 하면서 데이터베이스와 통신
 EntityManager em = emf.createEntityManager(); //엔티티 매니저 생성

엔티티 매니저 팩토리는 여러 스레드가 동시에 접근해도 안전하므로 서로 다른 스레드 간에 공유해도 되지만.
엔티티 매니저는 여러 스레드가 동시에 접근하면 동시겅 문제가 발생하므로
스레드 간에 절대 공유하면 안 된다.

그림 3.1 일반적인 웹 애플리케이션

EntityManagerFactory에서 다수의 엔티티 매니저를 생성
EntityManager1은 아직 데이터베이스 커넥션을 사용하지 않는다.
엔티티 매니저는 데이터베이스 연결이 꼭 필요한 시점까지 커넥션을 얻지 않는다.
예를 들어 트랜잭션을 시작할 때 커넥션을 회득한다.
EntityManager2는 커넥션을 사용중인데 보통 트랜잭션을 시작할 때 커넥션을 획득한다.
하이버네이트를 포함한 JPA 구현체들은 EntityManagerFactory를 생성할 때 커넥션풀도 만드는데(persistence.xml)에 보면 데이터베이스 접속 정보
JPA를 J2EE 환경(스프링 프레임워크 포함)에서 사용하면 해당 컨테이너가 제공하는 데이터소스를 사용한다.

3.2 영속성 컨텍스트란? <엔티티 영구 저장하는 환경>

JPA를 이해하는 데 가장 중요한 용어는 영속성 컨텍스트(persistence contxt)이다.
엔티티를 영구 저장하는 환경 이라는 뜻이다.
엔티티 매니저로 엔티티르르 저장하거나 조회하면 엔티티 맨저는 영속성 컨텍스트에 엔티티를 보관하고 관리한다.

em.persist(member) // 영속성 컨텍스트에 엔티티를 보관 관리

// 단순히 회원 엔티티를 저장한다고 표현 ->
// persist() 메소드는 엔티티 매니저를 사용해서 회원 엔티티를 영속성 컨텍스트에 저장한다.

persist() 메소드는 엔티티 매니저를 사용해서 회원 엔티티를 영속성 컨텍스트에 저장한다.

영속성 컨텍스트는 엔티티 매니저를 생성할 때 하나 만들어진다.
엔티티 매니저를 통해서 영속성 컨텍스트에 접근할 수 있고, 영속성 컨텍스트를 관리 할 수 있다.

* 참고

여러 엔티티 매니저가 같은 영속성 컨텍스트에 접근할 수도있다.
하나의 엔티티 매니저에 하나의 영속성 컨텍스트가 만들어진다고 생각하자.

3.3 엔티티의 생명 주기

엔티티에는 4가지 상태가 존재한다.

비영속(new/transient) : 영속성 컨텍스트와 전혀 관계가 없는 상태
영속(managed): 영속성 컨텍스트에 저장된 상태
준영속(detached): 영속성 컨텍스트에 저장되었다가 분리된 상태
상제(removed): 삭제된 상태

그림 3.2는 엔티티의 생명 주기를 나타낸 그림이다.

그림 3.2는 엔티티의 생명 주기

생명 주기

1. 비영속 (New/transiend)

// 객체를 생성한 상태(비영속)
Member member = new Member();
member.setId("member1");
member.setUsername("회원1");

엔티티 객체를 생성했다.
지금은 순수한 객체 상태이며 아직 저장하지 않았다.
따라서 영속성 컨텍스트나 데이터베이스와는 전혀 관련이 없다.

그림 3.3 em.persist() 호출전, 비영속 상태

영속<Managed>

엔티티 매니저를 통해서 엔티티를 영속성 컨텍스트에 저장했다.
영속성 컨텍스트가 관리하는 엔티티 영속 상태라 한다
회원 엔티티는 비영속 상태에서 영속 상태가 되었다.
경국 영속 상태라는 것은 영속성 컨텍스트에 의해 관리 된다는 뜻이다.

// 객체를 저장하는 상태(영속)
em.persist(member);

그림 3.4 em.persist() 호출 후, 영속 상태

준영속 <Detached>관리 => 비관리

컨텍스트가 관리하던 영속 상태의 엔티티를 영속성 컨텍스트가 관리 하지 않으면 준영속 상태가 된다.
엔티티를 준영속 상태로 만들려면 em.detach()를 호출하면 된다.
em.close()를 호출해서 영속성 컨텍스트를 닫거나 em.clear()를 호출해서 영속성 컨텍스트를 초기화해도
영속성 컨텍스트가 관라히던 영속 상태의 엔티티는 준영속 상태가 된다.

// 회원 엔티티를 영속성 컨택스트에서 분리, 준영속 상태
em.detach(member);

삭제

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

// 객체를 삭제한 상태(삭제)
em.remove(member);

3.4 영속성 컨텍스트의 특징

영속성 컨텍스트의 특징은 다음과 같다.

영속성 컨텍스트와 식별자 값

영속성 컨텍스트는 엔티티를 식별자 값(@Id로 테이블의 기본 키와 매핑한 값)으로 구분한다.
영속 상태는 식별자 값이 반드시 있어야 한다.
식별자 값이 없으면 예외가 발생한다.

영속성 컨텍스트와 데이터베이스 저장 (flush)

영속성 컨텍스트에 엔티티를 저장하면 이 엔티티는 언제 DB에 저장될까?
JPA는 보통 트랜잭션을 커밋하는 순간 영속성 컨텍스트에 새로 저장된 엔티티를 데이터베이스에 반영한다.
이것이 플러시(flush)이다.

영속성 컨텍스트가 엔티티를 관리하면 다음과 같은 장점이 있다.

1차 캐시
동일성 보장
트랜잭션을 지원하는 쓰기 지연
변경 감지
지연 로딩

3.4.1 엔티티 조회 <영속성 컨텍스트 내부 -> 캐시가 있다.>

영속성 컨텍스트는 내부에 캐시를 가지고 있는데 이것을 1차 캐시라 한다.
영속 상태의 에닡티는 모두 이곳에 저장한다.
영속성 컨텍스트 내부에 Map에 하나 있는데
키는 @Id로 매핑한 식별자고 값은 엔티티 인스턴스다.
1차 캐쉬 -> 영속성 엔티티가 저장 -> Map이 있는데 @Id가 식별자

// 엔티티를 생성한 상태 (비영속)
Member member = new Member();
member.setId("member1");
member.setUsername("회원1");

// 그림 3.5처럼 1차 캐시에 회원 엔티티를 저장한다.. 
// 아직 데이터베이스에 저장되지 않았다.

그림 3.5 영속성 컨텍스트 1차 캐시

1차 캐시의 키는 식별자 값이다. (Key 값 -> 식별자)
식별자 값은 데이터베이스 기본 키와 매핑되어 있다.
영속성 컨텍스트에 데이터를 저장하고 조회하는 모든 기준은 데이터베이스 기본 키 값이다.

Member member = em.find(Member.class, "member1");

Find() 메소드를 보면 첫 번째 파라미터는 엔티티 클래스의 타입이고.
두 번째는 조회할 엔티티의 식별자 값이다.

// EntityManager.find() 메소드 정의
public <T> T find(Class<T> entityClass, Object primaryKey);

em.find()를 호출하면 먼저 1차 캐시에서 엔티티를 찾고
만약 찾는 엔티티가 1차 캐시에 없으면 데이터베이스에서 조회한다.

1차 캐시에서 조회

그림 3.6을 보자. Em.find()를 호출하면 우선 1차 캐시에서 식별자 값으로 엔티티를 찾는다.
만약 찾는 엔티티가 있으면 데이터베이스를 조회하지 않고
메모리에 있는 1차 캐시에서 엔티티를 조회한다.

그림 3.6 1차 캐시에서 조회

        Member member = new Member();
        member.setId(id);
        member.setUsername("지한");

        //등록
        // 1차 캐시에 저장됨
                // 영속 컨텍스트 -> 1차 캐시 확인
        em.persist(member);

        //한 건 조회
        // 1차 캐시에서 조회
                // 1차 캐쉬 있으면 -> 캐쉬에서 find()
        Member findMember = em.find(Member.class, id);

데이터 베이스에서 조회 <1차 캐쉬 조회 -> 성능 조회>

em.find()를 호출했는데 엔티티가
1차 캐시에 없으면 엔티티 매니저는 데이터베이스를 조회해서 엔티티를 생성한다.
그리고 1차 캐시에 저장한 후에 영속 상태의 엔티티를 반환한다.

Member findMember2 = em.find(Member.class, "member2");

그림 3.7 1차 캐시에 없어 데이터베이스 조회

그림 3.7을 분석해보자.

em.find(Member.class, "member2")를 실행한다.
member2가 1차 캐시에 없으므로 데이터베이스에서 조회한다. (DB 조회)
조회한 데이터로 member2 엔티티를 생성해서 1차 캐시에 저장한다(영속 상태).
조회한 엔티티를 반환한다.

이제 member1, member2 엔티티 인스턴스는 1차 캐시에 있다.
이 엔티티들을 조회하면 메모리에 있는 1차 캐시에서 바로 불러온다.
성능상의 이점을 누릴수 있다.

영속 엔티티의 동일성 보장

다음 코드를 통해 식별자가 같은 엔티티 인스턴스를 조회해서 비교해보자.
Member a = em.find(Member.class, "member1"); Member b = em.find(Member.class, "member2"); print(a == b) // True 동일성 보장
em.find(Member.class, "member1");를 반복해서 호출해도 영속성 컨텍스트는
1차 캐시에 있는 같은 엔티티 인스턴스를 반환한다.
둘은 같은 인스턴스고 결과는 당연히 참이다.
영속성 컨텍스트는 성능상 이점과 엔티티의 동일성을 보장한다.

* 참고

동일성과 동등성
- 동일성 (identity): 실제 인스턴스가 같다. 따라서 참조 값을 비교하는 == 비교의 값이 같다.
- 동등성 (equality): 실제 인스턴스는 다를 수 있지만, 인스턴스가 가지고 있는 값이 같다. 자바에서 동등성 비교는 equals() 메소드를 구현

반복 읽기 -> DB는 사용 XXX -> 애플리 케이션 차원 제공
JPA는 1차 캐시를 통해 반복 가능한 읽기(REPEATABLE) 등급의 트랜잭션 격리 수준을
데이터 베이스가 아닌 애플리 케이션 차원에서 제공한다는 장점이 있다. 
트랜잭션 격리 수준은 16.1절에서 알아본다.

3.4.2 엔티티 등록 (persist) <쓰기 지연 설명 -> 성능 최적화>

엔티티 매니저를 사용해서 엔티티를 영속성 컨텍스트에 등록해보자

EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpabook");
EntityManager em = emf.createEntityManager(); //엔티티 매니저 생성
EntityTransaction transcation = em.getTransaction(); //트랜잭션 기능 획득

// 엔티티 매니저는 데이터 변경 시 트랜잭션을 시작해야 한다.
transcation.befin(); // 트랜잭션 시작

// 쓰기 지연
em.persist(memberA);
em.persist(memberB);
// 여기 까지 INSERT SQLdㅡㄹ 데이터베이스에 보내지 않는다.

// 커밋하는 순간 데이터베이스에 INSERT SQL을 보낸다.
// flush() - Transaction Commit
transaction.commit(); // 트랜잭션 커밋

엔티티 메니저는 트랜잭션을 커밋하기 직전까지 데이터베이스에 엔티티를 저장하지 않고
내부 쿼리 저장소에 INSERT SQL을 차곡차곡 모아둔다.
트랜잭션을 커밋할 때 모아둔 쿼리를 데이터베이스에 보내는데 이것을 트랜잭션을 지원하는 쓰기 지원(transactional write-behind)한다.

그림 3.8 쓰기 지연, 회원 A 영속

그림 3.8을 보면 먼저 회원 A를 영속화했다.
영속성 컨텍스트는 1차 캐시에 회원 엔티티를 저장하면서 동시에 회원 엔티티 정보로 등록 쿼리를 만든다.
그리고 만들어진 등록 쿼리를 쓰기 지연 SQL 저장소에 보관한다.

그림 3.9 쓰기 지연, 회원 B 영속

다음으로 회원 B을 영속화 했다.
회원 엔티티 정보로 등록 쿼리를 생성해서 쓰기 지연 SQL 저장소에 보관한다.
현재 쓰기 지연 SQL 저장소에는 등록 쿼리가 2건 저장되었다.

그림 3.10 쓰기 지연, 커밋

그림 3.10을 보면 마지막으로 트랜잭션을 커밋했다.
트랜잭션을 커밋하면 엔티티 매니저는 우선 영속성 컨텍스트를 플러시 한다.
플러시는 영속성 컨텍스트의 변경 내용을 데이터베이스에 동기화 하는 작업인다. 이때 등록, 수정, 삭제한 엔티티를 데이터베이스에 반영한다.
쓰기 지연 SQL저장소에 모인 쿼리를 데이터베이스에 보낸다.
영속성 컨텍스트의 변경 내용을 데이터베이스에 동기화 한 후에 실제 데이터베이스 트랜잭션을 커밋한다.

트랜잭션을 지원하는 쓰기 지연이 가능한 이유

다음 로직을 2가지 경우로 생각해보자

begin(); // 트랜잭션 시작


save(A);
save(B);
save(C);

commit(); // 트랜잭션 커밋

DB에 반영하는 방법 ( 즉시 반영 VS 지연 반영)

쓰기 지연 유무
X (DB 즉시 반영)	데이터를 저장하는 즉시 등록 쿼리를 데이터베이스에 보낸다.
	Save() 메소드를 호출할 때마다 즉시 데이터베이스에 등록 쿼리를 보낸다.
	그리고 마지막에 트랜잭션을 커밋한다.
O (DB 지연 반영)	데이터를 저장하면 등록 쿼리를 데이터베이스에 보내지 않고 메모리에 모아둔다.
	그리고 트랜잭션을 커밋할 때 모아둔 등록 쿼리를 데이터베이스에 보낸 후에 커밋한다.

A, B, C 모두 트랜잭션을 커밋하면 함께 저장되고 롤백하면 함께 저장되지 않는다.
등록 쿼리를 그때 그때 데이터베이스에 전달해도 트랜잭션을 커밋하지 않으면 아무 소용이 없다.
어떻게든 커밋 직전에만 데이터베이스에 SQL을 전달하면 된다.
이 기능을 잘 활용하면 모아둔 등록 쿼리를 데이터베이스에 한 번에 전달해서 성능을 최적화할 수 있다.

3.4.3 엔티티 수정

SQL 수정 쿼리의 문제점

SQL을 사용하면 수정 쿼리를 직접 작성해야 한다.
요구 사항이 늘이나면 수정 쿼리도 점점 추가 된다.

SQL 수정 쿼리의 문제점

실수로 등급 정보를 입력하지 않거나, 등급을 변경하는 데 실수로 이름과 나이를 입력하지 않을 수 있다.
결국 부담스러운 상황을 피하기 위해 수정 쿼리를 상황에 따라 계속해서 추가한다.
이런 개발 방식의 문제점은 수정 쿼리가 많아지는 것은 물론이고 비즈니스 로직을 분석하기 위해
SQL을 계속 확인해야 한다. 결국 직접적이든 간접적이든 비즈니스 로직이 SQL에 의존하게 된다.

변경 감지 (스냅샷을 이용한 변경)

그럼 JPA는 엔티티를 어떻게 수정할까

EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpabook");
EntityManager em = emf.createEntityManager(); //엔티티 매니저 생성
EntityTransaction transcation = em.getTransaction(); //트랜잭션 기능 획득

// 엔티티 매니저는 데이터 변경 시 트랜잭션을 시작해야 한다.
transcation.befin(); // 트랜잭션 시작

// 영속 엔티티 조회
Member memberA = em.find(Member.class, "memberA");

// 영속 엔티티 데이터 수정
memberA.setUsername("hi");
memberA.setAge(10);

// em.uPdate(member) 이런 코드가 있어야 하지 않을까?

transaction.commit(); // 트랜잭션 커밋

JPA로 엔티티를 수정할 때는 단순히 엔티티를 조회해서 데이터만 변경하면 된다.
트랜잭션 커밋 직전에 주석으로 처리된 em.update() 메소드를 실행해야 할 것 같지만 이런 메소드는 없다.
엔티티의 변경사항을 데이터베이스에 자동으로 반경ㅇ하는 기능을 변경 감지(dirty checking)라 한다.

그림 3.11 변경 감지

JPA는 엔티티를 영속성 컨텍스트에 보관할 때, 최초 상태를 복사해서 저장해두는데 이것을 스냅샷이라 한다.
플러시 시점에 스냅샷과 엔티티를 비교해서 변경된 엔티티를 찾는다.
1. 영속성 보관시 2. 최초 상태를 복사해 저장 3. flush 시점 비교

그림 3.11을 순서대로 분석

트랜잭션을 커밋하면 엔티티 매니저 내부에서 먼저 플러시(flush)가 호출
엔티티와 스냅샷을 비교해서 변경된 엔티티를 찾는다.
변경된 엔티티가 있으면 수정 쿼리를 생성해서 쓰기 지연 SQL 저장소에 보낸다.
쓰기 지연 저장소의 SQL을 데이터베이스에 보낸다.
데이터베이스 트랜잭션을 커밋한다.

변경 감지는 영속성 컨텍스트가 관리하는 영속 상태의 엔티티에만 적용된다.
비영속, 준영속처럼 영속성 컨텍스트의 관리를 받지 못하는 엔티티는 값을 변경해도 데이터베이스에 반영되지 않는다.
(비영속, 준영속 -> DB 반영 X)
이번에는 변경 감지로 인해 실행된 UPDATE SQL을 자세히 알아보자.

JPA의 UPDATE 전략은 엔티티의 모든 필드를 업데이트

실제 JPA의 기본 적략은 예제 3.5처럼 엔티티의 모든 필드를 업데이트한다

UPDATE MEMBER
SET
    NAME=?,
    AGE=?,
    GRADE=?,
    ...
WHERE
    id=?

모든 필드를 사용하면 데이터베이스에 보내는 데이터 전송량이 증가하는 단점이 있지만 장점도있다

장점
수정 쿼리 재사용	모든 필드를 사용하면 수정 쿼리가 항상 같다(물론 바인딩되는 데이터는 다르다). 따라서 애플리케이션 로딩 시점에 수정쿼리를 미리 생성해두고 재사용할 수 있다.
데이터베이스 파싱된 쿼리 재사용	데이터베이스에 동일한 쿼리를 보내면, 데이터베이스는 이전에 한번 파싱된 쿼리를 재사용할 수 있다.

모든필드 사용 -> 수정쿼리 비슷 -> 재사용
DB에서 같으면 재사용

@DynamicUpdate 사용

필드가 많거나 저장되는 내용이 너무 크면 수정됭 데이터만 사용해서 동적으로 UPDATE SQL을 생성하는 전략을 선택하면 된다.
단. 이때는 하이버네이트 확장기능을 사용해야한다.

@Entity
@org.hibbernate.annotations.DynamicUpdate
@Table(name = "Member")
public class Member {...}

이렇게 org.hibbernate.annotations.DynamicUpdate 어노테이션을 사용하면 수정된 데이터만 사용해서
동적으로 UPDATE SQL을 생성한다.
참고로 데이터를 저장할때 데이터가 존재하는 (null이 아닌) 필드만으로 INSERT SQL을 동적으로 생성하는 @DynamicInsert도있다.

* 참고

상황에 따라 다르지만 컬럼이 대략 30개 이상이 되면 기본적인 정적 수정 쿼리보다.
@DynamicUpdate를 사용한 동적 수정 쿼리가 빠르가.
가장 정확한 것은 본인의 환경에서 직접 테스트해보는 것이다.
추천하는 방법은 기본 적략을 사용하고, 최적화가 필요할 정도로 느리면 그때 전략을 수정하면 된다.
참고로 한 테이블에 컬럼이 30개 이상 된다는 것은 테이블 설계상 책임이 적절히 분리되지 않았을 가능성이 높다.

3.4.4 엔티티 삭제

엔티티를 삭제하려면 먼저 삭제 대상 엔티티를 조회해야 한다.

Member memberA = em.find(Member.class, "memberA"); // 샥제 대상 엔티티 조회
em.remove(memberA); // 엔티티 삭제

em.remove()에 삭제 대상 엔티티를 넘겨주면 엔티티를 삭제한다.
물론 엔티티를 즉시 삭제하는 것이 아니라
엔티티 등록과 비슷하게 삭제 쿼리를 쓰기 지연 SQL 저장소에 등록한다.
트랜잭션을 커밋해서 플러시를 호출하면 실제 데이터 베이스에 삭제 쿼리를 전달한다.

참고
Em.remove(memberA)를 호출하는 순간 memberA는 영속성 컨텍스트에서 제거된다.
삭제된 엔티티는 재사용하지 말고 자연스럽게 가비지 컬렉션의 대상이 되도록 두는 것이 좋다.

3.5 플러시 (flush())

플러시(flush())는 영속성 컨텍스트의 변경 내용을 데이터베이스에 반영한다.
플러시를 실행하면 구체적으로 다음과 같은 일이 일어난다.

1. 변경 감지가 동작해서 영속성 컨텍스트에 있는 모든 엔티티를 스냅샷과 비교해서 수정된 엔티티를 찾는다.
2. 수정된 엔티티는 수정 쿼리를 만들어 쓰기 지연 SQL 저장소에 등록한다.
2. 쓰기 지연 SQL 저장소의 쿼리를 데이터베이스에 전송한다(등록, 수정, 삭제 쿼리)

영속성 컨텍스트를 플러시하는 방법은 3가지이다.

Em.flush()을 직접 호출한다. (직접 호출)
트랜잭션 커밋 시 플러시가 자동 호출된다. (커밋시 자동 호출)
JPQL 쿼리 실행 시 플러시가 자동 호출된다. (JPQL 실행시)

직접 호출 (em.flush)

엔티티 매니저의 flush() 메소드를 직접 호출해서 영속성 컨텍스트를 강제로 플러시 한다.
테스트나 다른 프로임워크와 JPA를 함께 사용할 때를 제외하고 거의 사용하지 않는다.

트랜잭션 커밋 시 플러시 자동 호출 (커밋시 flush 자동 호출)

데이터베이스에 변경 내용을 SQL로 전달하지 않고
트랜잭션만 커밋하면 어떤 데이터도 데이터베이스에 반영되지 않는다.
트랜잭션을 커밋하기 전에 꼭 플러시를 호출해서 영속성 컨텍스트의 변경 내용을 데이터베이스에 반영해야한다.
JPA는 이런 문제를 예방하기 위해 트랜잭션을 커밋할 때 플러시를 자동으로 호출

JPQL 쿼리 실행 시 플러시 자동 호출

JPQL이나 Criterial(10장에서 설명) 같은 객체지향 쿼리를 호출할 때도 플러기가 실행된다.
JPQL 쿼리를 실행 할 때 플러시가 자동 호출될까?

왜 JPQL 쿼리 실행시 플러시 자동 호출 될까?

em.persist(memberA);
em.persist(memberB);
em.persist(memberC);

// 중간에 JPQL 실행
query = em.createQuery("SELECT m FROM Member m", Member.class);
List<Member> members = query.getResultList();

먼저 em.persist()를 호출해서 엔티티 memberA, memberB, memberC를 영속 상태로 만들었다.
이 엔티티들은 영속성 컨텍스트에는 있지만 아직 데이터베이스에는 반영되지 않았다.
이때 JPQL을 실행하면
JPQL은 SQL로 변환되어 데이터베이스에서 엔티티를 조회한다.
그런데 memberA, memberB, memberC는 아직 데이터베이스에 없으므로 쿼리 결과로 조회되지 않는다.
따라서 쿼리를 실행하기 직전에 영속성 컨텍스트를 플러시 해서 변경 내용을 데이터베이스에 반영해야 한다.
JPA는 이런 문제를 예방하기 위해 JPQL을 실행할 때도 플러시를 자동 호출한다.
따라서 memberA, memberB, membecC도 쿼리 결과에 포함된다.
참고 -> 식별자를 기준으로 조회하는 find() 메소드를 호출할 때는 플러시가 실행되지 않는다.

3.5.1 플러시 모드 옵션 <flush 반영 커스텀>

- FlushModeType.AUTO : 커밋이나 쿼리를 실행할 때 플러시(기본값)
- FlushModeType.COMMIT : 커밋할 때만 플러시

플러시 모드를 별도로 설정하지 않으면 AUTO로 동작한다.
따라서 트랜잭션 커밋이나 쿼리 실행 시에 플러시를 자동으로 호출한다.
대부분 AUTO 기본 정을 그대로 사용한다.
COMMIT 모드는 성능 최적화를 위해 사용할 수 있다.

em.setFlushMode(FlushModeType.COMMIT) // 플러시 모드 직접 설정

플러시라는 이름으로 인해 영속성 컨텍스트에 보관된 엔티티를 지운다고 생각하면 안된다.
강조한다. 영속성 컨텍스트의 변경 내용을 데이터베이스에 동기화 하는 것이 플러시이다.
데이터베이스와 동기화를 최대한 늦추는 것이 가능한 이유는 트랜잭션이라는 작업 단위가 있기 때문이다.
트랜잭션 커밋 직전에만 변경 내용을 데이터베이스에 보내 동기화하면 된다.

3.6 준영속 <close, detach, clear>

지금까지 엔티티의 비영속 -> 영속 -> 삭제 상태 변화를 알아보았다.
이번에는 영속 -> 준영속의 상태 변화를 알아보자.
영속성 컨텍스타가 관리하는 영속 상태의 엔티티가 영속성 컨텍스트에서 분리도니 (detached) 것을 준영속 상태라고 한다.
준영속 상태의 엔티티는 영속성 컨텍스트가 제공하는 기능을 사용할 수 없다.

em.detach(entity) : 특정 엔티티만 준영속 상태로 전환한다.
em.clear() : 영속성 컨텍스트를 완전히 초기화 한다.
em.close() : 영속성 컨텍스트를 종료한다.

3.6.1 엔티티를 준영속 상태로 전환 : detach()

em.detach() 메소드는 특정 엔티티를 준영속 상태로 만든다.

public void testDetached(){
  ...
    // 회원 엔티티 생성, 비영속 상태
  Member member = new Member();
  member.setId("memberA");
  member.setUsername("회원A");

  // 회원 엔티티 영속 상태
  em.persist(member);

  // 회원 엔티티를 영속성 컨텍스트에서 분리, 준영속 상태
  em.detach(member);

  transaction.commit(); // 트랜잭션 커미
}

회원 엔티티를 생성하고 영속화한 다음 em.detach(member)을 호출했다.
영속성 컨텍스트에게 더는 해당 엔티티를 관리하지 말라는 것이다.
이 메소드를 호출하는 순간 1차 캐시부터 쓰기 지연 SQL 저장소까지 해당 엔티티를 관리하기 위한 모든 정보가 제거된다.

그림 3.12 detach 실행 전

그림 3.13 detach 실행 후

그리 3.12, 그림 3.13에서 보는 것처럼 영속성 컨텍스트에서 memberA에 대한 모든 정보를 삭제해 버렸다.
영속 상태였다가 더는 영속성 컨텍스트가 관리하지 않는 상태를 준영속 상태라 한다.
이미 준영속 상태이므로 영속성 컨텍스트가 지원하는 어떤 기능도 동작하지 않는다.
심지어 쓰기 지연 SQL 저장소의 INSERT SQL도 제거되어서 데이터베이스에 저장되지도 않는다.
정리하자면 영속 상태가 영속성 컨텍스트로부터 관리(managed)되는 상태라면
준영속 상태는 영속성 컨텍스트로부터 분리(detached)된 상태다.

3.6.2 영속성 컨텍스트 초기화: clear() <영속성 컨텍스트 모든 엔티티 초기화>

em.detach() 가 특정 엔티티 하나를 준영속 상태로 만들었다면
em.clear()는 영속성 컨텍스트를 초기화해서 해당 영속성 컨텍스트의 모든 엔티티를 준영속성 상태로 만든다.

// 엔티티 조회, 영속 상태
Member member = em.find(Member.class, "memberA");

em.clear(); // 영속성 컨텍스트 초기화

// 준영속 상태
member.setUsername("changeName");

그림 3.14 영속성 컨텍스트 초기화 전

그림 3.15 영속성 컨텍스트 초기화 후

영속성 컨텍스트에 있는 모든 것이 초기화 되어 버렸다.
영속성 컨텍스트를 제거하고 새로 만든 것과 같다.
이제 memberA, memberB는 영속성 컨텍스트가 관리하지 않으므로 준영속 상태다.

member.setUsername("changeName"); // 준영속 상태이므로 반영되지 않는다.

준영속 상태이므로 영속성 컨텍스트가 지원하는 변경 감지는 동작하지 않는다.
회원의 이름을 변경해도 데이터베이스에 반영되지 않는다.

3.6.3 영속성 컨텍스트 종료: close()

영속성 컨텍스트를 종료하면 해당
영속성 컨텍스트가 관리하던 영속 상태의 엔티티가 모두 준영속 상태가 된다.

public void closeEntityManager() {
  EntityManagerFactory emf = 
    Persistence.createEntityManagerFactory("jpabook");

  EntityManagr em = emf.createEntityManager();
  EntityTransaction transaction = em.getTransaction();

  transaction.begin(); // [트랜잭션] - 시작

  Member memberA = em.find(Member.class, "memberA");
  Member memberB = em.find(Member.class, "memberB");

  transaction.commit(); // [트랜잭션] - 커밋

  em.close(); // 영속성 컨텍스트 닫기(종료) -> 관리된는 엔티티 비영속
}

그림 3.16 영속성 컨텍스트 제거 전

그림 3.17 영속성 컨텍스트 제거 후

* 참고

영속 상태의 엔티티는 주로 영속성 컨텍스트가 종료되면서 준영속 상태가 된다.
개발자가 직접 준영속 상태로 만드는 일은 드물다.

3.6.4 준영속 상태의 특징

그럼 준영속 상태인 회원 엔티티는 어떻게 되는 걸까?

거의 비영속 상태에 가깝다.

영속성 컨텍스트가 관리 하지 않으므로 1차 캐시, 쓰기 지연, 변경 감지, 지연 로딩을 포함한
영속성 컨텍스트가 제공하는 어떠한 기능도 동작하지 않는다.

식별자 값을 가지고 있다. (한번 영속된 경험)

비영속 상태는 식별자 값이 없을 수도있지만
준영속 상태는 이미 한 번 영속 상태였으므로 반드시 식별자 값을 가지고 있다.

지연 로딩을 할 수 없다.

지연 로딩(LAZY LOADING)은 실제 객체 대신 프록시 객체를 로딩해두고
해당 객체를 실제 사용할 때 영속성 컨텍스트를 통해 데이터를 불러오는 방법이다.
영속 상태는 영속성 컨텍스트가 더는 관리하지 않으므로 지연 로딩 시 문제가 발생한다.

3.6.5 변합: merge() (준영속 -> 영속)

준영속 상태의 엔티티를 다시 영속 상태로 변경하려면 병합을 사용하면 된다.
Merge() 메소드는 준 영속 상태의 엔티티를 받아서 그 정보로 새로운 영속 상태의 엔티티를 반환한다.

// dㅖ제 3.11 merge() 메소드 정의
public <T> T merge(T entity);

// 예제 3.12 merge() 사용 예
Member mergeMember = em.merge(member);

준영속 병합 (merge())

// 예제 3.13 준영속 병합 예제
public class ExaMergeMain(){
  static EntityManagerFactory emf = 
    Persistence.createEntityManagerFactory("jpabook");

  public static void main(String args[]){
    Member member = createMember("memberA", "회원1"); // 1.번
    member.setUsername("회원명변경"); // 2.번 준영속 상태에서 변경 (반영X)
    mergeMember(member); // 3.번

    static Member createMember(String id, String username){
      // ==== 영속성 컨텍스트 1 시작
      EntityManager em1 = emf.createEntityManager();
      EntityTransaction tx1 = em1.getTransaction();
      tx1.begin();

      // member 등록
      Member member = new Member();
      member.setId(id);
      member.setUsername(username);

      em1.persist(member);
      tx1.commit();

      em1.close(); // 영속성 컨텍스트1 종료, member 엔티티는 준영속 상태가 된다.
      // ==== 영속성 컨텍스트1 종료

      return member;
    }

    static void mergeMember (Member member){
      // === 영속성 컨텍스트2 시작
      EntityManager em2 = emf.createEntityManager();
      EntityTransaction tx2 = em2.getTransaction();

      // 비영속 => 영속
      tx2.begin(); 
      Member mergeMember = em2.merge(member);
      ttx2.commit();

      // 준영속 상태
      System.out.pringln("member = " + member.getUsername());

      // 영속 상태
      System.out.println("mergeMember = " + mergeMember.getUsername());

      System.out.println(em2.contains(member)); // false => 비 영속 상태
      System.out.println(em2.contains(mergeMember)); // true => 영속상태

      em2.close();
      // === 영속성 컨텍스트2 종료 ==
    }
  }
}

// 출력 결과는 다음과 같다.
member = 회원명변경
mergeMember = 회원명변경
em2 contains member = false
em2 contains mergeMember = true

병합이 끝나고 tx2.commit()을 호출해서 트랜잭션을 커밋했다.
mergeMember의 이름이 "회원1"에서 "회원명변경"으로 변경되었으므로 변경
변경 감지 기능이 동작해서 변경 내용을 데이터베이스에 반영한다.
Merge()는 파라미터로 넘어온 준영속 엔티티를 사용해서
새롭게 병합된 영속 상태의 엔티티를 반환한다.
파라미터로 넘어온 엔티티는 병합 후에도 준영속 상태로 남아있다. -> 비영속 엔티티=> 새롭게 병합된 엔티티
코드의 출력 부분을 보면
em.contains(entity)는 영속성 컨텍스트가 파라미터로 넘어온 엔티티를 관리하는지 확인하는 메소드이다.
member를 파라미터로 넘겼을 때는 반환 결과가 falseek.
반면에 mergeMember는 true를 반환한다.
따라서 준영속 상태인 m ember 엔티티와 영속 상태인 mergeMember 엔티티는 서로 다른 인스턴스다.
준영속 상태인 member는 이제 사용할 필요가 없다.
따라서 다음과 같이 준영속 엔티티를 참조하던 변수를 영속 엔티티를 참조하도록 변경하는 것이 안전하다.

// 다음과 같이 준영속 엔티티를 참조하던 변수를 영속 엔티티를 참조하도록 변경하는 것이 안전하다
member = em2.merge(member);

1. 번

Member 엔티티는 createMember() 메소드의 영속성 컨텍스트1에서 영속 상태였다가 영속성 컨텍스트1이 종료되면서 준영속 상태가 되었다.
따라서 createMember() 메솓는 준영속 상태의 member 엔티티를 반환한다.

2. 번

Main() 메소드에서 m ember.setUsername("회원명변경")을 호출해서 회원 이름을 변경했지만
준영속 상태인 Member 엔티티를 관리하는 영속성 컨텍스트가 더는 존재하지 않으므로 수정 사항을 데이터베이스에 반영할 수 없다.

3.번

준영속 상태의 엔티티를 수정하려면 준영속 상태를 다시 영속 상태로 변경해야 하는데
이때 병합(merge)을 사용한다.
mergeMember() 메소드에서 새로운 영속성 컨텍스트2를 시작하고 em2.merge(member)fmㄹ 호출해서 준영속 상태의 m ember dpㄴ티티를 영속성 컨텍스트2를 시작하고
em2.merge(member)fmㄹ 호출해서 준영속 상태의 m ember 엔티티를 영속성 컨텍스트2가 관리하는 영속 상태로 변경했다.
영속 상태이므로 트랜잭션을 커밋할 때 수정했던 회원 명이 데이터베이스에 반영된다.
(정확히는 member 엔티티가 준영속 상태에서 영속 상태로 변경되는 것은 아니고 m ergeMember 라는 새로운 영속 상태의 엔티티가 반환된다.)

그림 3.18 준영속 병합 - 수정

Merge()을 실행한다.
파라미터로 넘어온 준영속 엔티티의 식별자 값으로 1차 캐시에서 엔티티를 조회한다.
-1 만약 1차 캐시에서 엔티티가 없으면 데이터베이스에서 엔티티를 조회하고 1차 캐시에 저장한다.
조회한 영속 엔티티(mergeMember)dㅔ member 엔티티의 값을 채워 넣는다.
(member 엔티티의 모든 값을 mergeMember에 밀어 넣는다. 이때 mergeMember의 "회원1"이라는 이름이 "회원명변경"으로 바뀐다.)
mergeMember를 반환한다.

비영속 병합 (merge은 비영속 엔티티를 영속 상태로 만들수 있다.)

병합은 merge은 비영속 엔티티도 영속 상태로 만들수 있다.

Member member = new Member()
Member newMember = em.merge(member); // 비영속 병합
tx.commit();

병합은 파라미터로 넘어온 엔티티의 식별자 값으로 영속성 컨텍스트를 조회하고
찾는 엔티티가 없으면 데이터베이스에서 조회한다.
만약 데이터베이스에서도 발견하지 못하면 엔티티를 생성해서 병합한다.
병합은 준영속, 비영속을 신경 쓰지 않는다.
식별자 값으로 엔티티를 조회할 수 있으면 불러서 병합하고
조회할 수 없으면 새로 생성해서 병합한다.
따라서 병합은 save or update 기능을 수행한다.
Merge -> 식별자 => DB (X) => 새로 생성 병합

3.7 정리

엔티티 매니저는 엔티티 매니저 팩토리에서 생성한다.

자바를 직접 다루는 J2SE환경에서는 엔티티 매니저를 만들면 그 내부에 영속성 컨텍스트도 함께 만들어 진다.
잉 영속성 컨텍스트는 엔티티 매니저를 통해서 접근할 수 있다.

영속성 컨텍스트는 애플리케이션과 데이터베이스 사이에서 객체를 보관하는 기능상의 데이터베이스 같은 역할을 한다.

영속성 컨텍스트 덕분에 1차 캐시, 동일성 보장, 트랜잭션을 지원하는 쓰기 지연, 변경 감지, 지연로딩 기능을 사용할 수 있다.

영속성 컨텍스트에 저장한 엔티티는 플러시 시점에 데이터베이스에 반영된ㄴ데

일반적으로 트랜잭션을 커밋할 때 영속성 컨텍스트가 플러시 된다.
플러시(flush) => 데이터 베이스에 동기화 된다.

영속성 컨텍스트가 관리하는 엔티티를 영속 상태의 엔티티라 하는데

영속성 컨텍스타가 해당 엔티티를 더 이상 관리 하지 못하면
그엔티티를 준영속 상태의 엔티티라 한다.
준영속 상태의 엔티티는 더는 영속성 컨텍스트의 관리를 받지 못하므로 영속성 컨텍스트가 제공하는 1차 캐시, 동일성 보장, 트랜잭션을 지원하는
쓰기 지연, 변경 감지, 지연 로딩 같은 기능들을 사용할 수 없다.

지금까지 설명한 엔티티 매니저와 영속성 컨텍스트는 매핑한 엔티티를 실제 사용하는 동적인 부분에 해당한다.

엔티티와 테이블을 어떻게 매핑하는지 설계에 해당하는 정적인 부분을 알아보자.

영속성 컨텍트스
1. 1차 캐시, 쓰기 지연, 변경 감지, 지ㅕ연 로딩
2. 영속성 컨텍스트 덕분에 1차 캐시, 동일성 보장, 트랜잭션을 지원하는 쓰기 지연, 변경 감지, 지연 로딩 사용ㅅ
쓰기 지연
변경감지

'개인공부 > JPA' 카테고리의 다른 글

6장 다양한 연관관계 매핑 (1)	2024.02.05
5장 연관관계 매핑 기초 (1)	2024.02.05
4장 엔티티 매핑 (1)	2024.01.30
2장 JPA 시작 (0)	2024.01.20
1장 JPA 소개 (0)	2024.01.20

3장 영속성 관리

3장 영속성 관리

3.1 엔티티 매니저 팩토리와 엔티티 매니저

엔티티 매니저 팩토리

엔티티 매니저

3.2 영속성 컨텍스트란? <엔티티 영구 저장하는 환경>

* 참고

3.3 엔티티의 생명 주기

생명 주기

1. 비영속 (New/transiend)

영속<Managed>

준영속 <Detached>관리 => 비관리

삭제

3.4 영속성 컨텍스트의 특징

영속성 컨텍스트와 식별자 값

영속성 컨텍스트와 데이터베이스 저장 (flush)

영속성 컨텍스트가 엔티티를 관리하면 다음과 같은 장점이 있다.

3.4.1 엔티티 조회 <영속성 컨텍스트 내부 -> 캐시가 있다.>

1차 캐시에서 조회

데이터 베이스에서 조회 <1차 캐쉬 조회 -> 성능 조회>

영속 엔티티의 동일성 보장

* 참고

3.4.2 엔티티 등록 (persist) <쓰기 지연 설명 -> 성능 최적화>

트랜잭션을 지원하는 쓰기 지연이 가능한 이유

DB에 반영하는 방법 ( 즉시 반영 VS 지연 반영)

3.4.3 엔티티 수정

SQL 수정 쿼리의 문제점

SQL 수정 쿼리의 문제점

변경 감지 (스냅샷을 이용한 변경)

JPA의 UPDATE 전략은 엔티티의 모든 필드를 업데이트

@DynamicUpdate 사용

* 참고

3.4.4 엔티티 삭제

3.5 플러시 (flush())

직접 호출 (em.flush)

트랜잭션 커밋 시 플러시 자동 호출 (커밋시 flush 자동 호출)

JPQL 쿼리 실행 시 플러시 자동 호출

왜 JPQL 쿼리 실행시 플러시 자동 호출 될까?

3.5.1 플러시 모드 옵션 <flush 반영 커스텀>

3.6 준영속 <close, detach, clear>

3.6.1 엔티티를 준영속 상태로 전환 : detach()

3.6.2 영속성 컨텍스트 초기화: clear() <영속성 컨텍스트 모든 엔티티 초기화>

3.6.3 영속성 컨텍스트 종료: close()

* 참고

3.6.4 준영속 상태의 특징

거의 비영속 상태에 가깝다.

식별자 값을 가지고 있다. (한번 영속된 경험)

지연 로딩을 할 수 없다.

3.6.5 변합: merge() (준영속 -> 영속)

준영속 병합 (merge())

1. 번

2. 번

3.번

비영속 병합 (merge은 비영속 엔티티를 영속 상태로 만들수 있다.)

3.7 정리

'개인공부 > JPA' 카테고리의 다른 글

관련글

티스토리툴바