영속성 컨텍스트 심화 — 1차 캐시와 변경 감지는 어떻게 동작할까

// 영속성 컨텍스트 없이
User user = jdbcTemplate.queryForObject("SELECT * FROM users WHERE id = ?", mapper, 1L);
user.setName("새이름");
jdbcTemplate.update("UPDATE users SET name = ? WHERE id = ?", user.getName(), user.getId());
// 어떤 필드가 변경됐는지 직접 추적해야 함

// 영속성 컨텍스트 사용
User user = em.find(User.class, 1L); // 영속 상태
user.setName("새이름");              // 값만 변경
// 트랜잭션 커밋 시 자동으로 UPDATE 실행 (변경 감지)

비영속(new/transient)     → new User() 만 한 상태
    ↓ em.persist()
영속(managed)             → 영속성 컨텍스트가 관리하는 상태
    ↓ em.detach() / em.clear() / 트랜잭션 종료
준영속(detached)          → 영속성 컨텍스트에서 분리된 상태
    ↓ em.merge()
영속(managed)             → 다시 관리 상태로
    ↓ em.remove()
삭제(removed)             → 삭제 예약 상태

// 첫 번째 조회 → SELECT 쿼리 실행, 1차 캐시에 저장
User user1 = em.find(User.class, 1L); // SQL 실행

// 두 번째 조회 → 1차 캐시에서 반환, SQL 실행 안 함
User user2 = em.find(User.class, 1L); // SQL 미실행

System.out.println(user1 == user2); // true — 같은 인스턴스

영속성 컨텍스트 1차 캐시
┌────────────────────────────────────┐
│ Key (ID)  │ 엔티티 인스턴스  │ 스냅샷    │
├────────────────────────────────────┤
│ User@1    │ User{id=1, ...} │ {원본 복사} │
│ User@2    │ User{id=2, ...} │ {원본 복사} │
│ Order@10  │ Order{id=10, ..}│ {원본 복사} │
└────────────────────────────────────┘

@Transactional
public void updateUser(Long id, String newName) {
    User user = userRepository.findById(id).orElseThrow();
    user.setName(newName);
    // repository.save() 호출 불필요!
    // 트랜잭션 커밋 시 변경 감지로 자동 UPDATE
}

@Transactional
public void createUsers() {
    User user1 = new User("A");
    User user2 = new User("B");
    User user3 = new User("C");

    em.persist(user1); // INSERT SQL을 쓰기 지연 저장소에 보관
    em.persist(user2); // INSERT SQL 보관
    em.persist(user3); // INSERT SQL 보관

    // 아직 DB에 SQL 전송 안 됨
    // 트랜잭션 커밋 시점에 한꺼번에 전송
}

em.persist(new User("홍길동"));

// JPQL 실행 전에 자동 flush → 방금 persist한 User도 조회 가능
List<User> users = em.createQuery("SELECT u FROM User u", User.class).getResultList();

em.setFlushMode(FlushModeType.AUTO);   // 기본값: 커밋 시 + JPQL 시 flush
em.setFlushMode(FlushModeType.COMMIT); // 커밋 시에만 flush (JPQL 시 flush 안 함)

@Transactional
public void example() {
    User user = em.find(User.class, 1L); // 영속 상태

    em.detach(user); // 준영속 상태로 전환

    user.setName("변경"); // 변경 감지 안 됨 (준영속이므로)

    User mergedUser = em.merge(user); // 새로운 영속 엔티티 반환
    // 주의: user != mergedUser
    // user는 여전히 준영속, mergedUser가 영속 상태
}

// 배치 처리 시 메모리 관리
@Transactional
public void batchInsert(List<UserRequest> requests) {
    for (int i = 0; i < requests.size(); i++) {
        em.persist(new User(requests.get(i)));

        if (i % 100 == 0) {
            em.flush();  // DB에 전송
            em.clear();  // 1차 캐시 비움 → 메모리 절약
        }
    }
}

// 방법 1: 변경 감지 (권장)
@Transactional
public void updateName(Long id, String name) {
    User user = userRepository.findById(id).orElseThrow();
    user.setName(name);
    // 끝! save() 호출 불필요
}

// 방법 2: save() 호출 (불필요하지만 동작함)
@Transactional
public void updateName(Long id, String name) {
    User user = userRepository.findById(id).orElseThrow();
    user.setName(name);
    userRepository.save(user); // 이미 영속 상태이므로 merge가 실행됨 (불필요한 호출)
}

spring:
  jpa:
    open-in-view: true  # 기본값: true

HTTP 요청 → 영속성 컨텍스트 열림
  → 서비스 계층 (트랜잭션 시작/종료)
  → 컨트롤러 (영속성 컨텍스트 유지, Lazy 로딩 가능)
  → 뷰 렌더링 (Lazy 로딩 가능)
→ HTTP 응답 → 영속성 컨텍스트 닫힘 + DB 커넥션 반환

HTTP 요청
  → 서비스 계층 (영속성 컨텍스트 열림/닫힘, 트랜잭션 범위)
  → 컨트롤러 (Lazy 로딩 불가! LazyInitializationException)
→ HTTP 응답

spring:
  jpa:
    open-in-view: false  # 운영에서 권장

// 서비스에서 필요한 데이터를 미리 로드
@Transactional(readOnly = true)
public OrderResponse getOrderDetail(Long id) {
    Order order = orderRepository.findById(id).orElseThrow();

    // 서비스 안에서 Lazy 필드에 접근하여 로드
    return OrderResponse.builder()
        .id(order.getId())
        .userName(order.getUser().getName())  // Lazy 로딩 (트랜잭션 안)
        .items(order.getItems().stream()       // Lazy 로딩
            .map(ItemResponse::from)
            .toList())
        .build();
}

@Query("SELECT o FROM Order o JOIN FETCH o.user JOIN FETCH o.items WHERE o.id = :id")
Optional<Order> findByIdWithDetails(@Param("id") Long id);