~/tech-blog/posts/data-jpa-internals — zsh

스프링 데이터 JPA는 어떻게 동작하는가

스프링 데이터 JPA 구현체 분석

  • 스프링 데이터 JPA가 제공하는 공통 인터페이스의 구현체입니다.
  • org.springframework.data.jpa.repository.support.SimpleJpaRepository

리스트 12.31 SimpleJpaRepository

Java
@Repository
@Transactional(readOnly = true)
public class SimpleJpaRepository<T, ID> ...{

    @Transactional
        public <S extends T> S save(S entity) {
            if (entityInformation.isNew(entity)) {
                em.persist(entity);
                return entity;
            } else {
                return em.merge(entity);
            }
        }
    ...
}
  • @Repository 적용: JPA 예외를 스프링이 추상화한 예외로 변환합니다.
  • @Transactional 트랜잭션 적용
    • JPA의 모든 변경은 트랜잭션 안에서 동작합니다.
    • 스프링 데이터 JPA는 변경(등록, 수정, 삭제) 메서드를 트랜잭션 처리합니다.
    • 서비스 계층에서 트랜잭션을 시작하지 않으면 리포지토리에서 트랜잭션을 시작합니다.
    • 서비스 계층에서 트랜잭션을 시작하면 리포지토리는 해당 트랜잭션을 전파받아서 사용합니다.
    • 그래서 스프링 데이터 JPA를 사용할 때 트랜잭션이 없어도 데이터 등록, 변경이 가능했던 것입니다(사실은 트랜잭션이 리포지토리 계층에 걸려 있는 것입니다).
  • @Transactional(readOnly = true)
    • 데이터를 단순히 조회만 하고 변경하지 않는 트랜잭션에서 readOnly = true 옵션을 사용하면 플러시를 생략해서 약간의 성능 향상을 얻을 수 있습니다.
    • 자세한 내용은 JPA 책 15.4.2 읽기 전용 쿼리의 성능 최적화를 참고합니다.

매우 중요!!

  • save() 메서드
    • 새로운 엔티티면 저장(persist)합니다.
    • 새로운 엔티티가 아니면 병합(merge)합니다.

참고: 업데이트는 merge를 쓰는 게 아니라, 영속성 컨텍스트의 상태 관리를 사용해야 합니다. 머지는 영속성 컨텍스트의 관리를 받지 않을 때 관리해주기 위해 사용하는 것입니다.

  • 새로운 엔티티를 판단하는 기본 전략
    • 식별자가 객체일 때 null로 판단합니다.
    • 식별자가 자바 기본 타입일 때 0으로 판단합니다.
    • Persistable 인터페이스를 구현해서 판단 로직을 변경할 수 있습니다.
Java
package org.springframework.data.domain;
public interface Persistable<ID> {
    ID getId();
    boolean isNew();
}

참고: JPA 식별자 생성 전략이 @GenerateValuesave() 호출 시점에 식별자가 없으므로 새로운 엔티티로 인식해서 정상 동작합니다. 그런데 JPA 식별자 생성 전략이 @Id만 사용해서 직접 할당이면 이미 식별자 값이 있는 상태로 save()를 호출합니다. 따라서 이 경우 merge()가 호출됩니다. merge()는 우선 DB를 호출해서 값을 확인하고, DB에 값이 없으면 새로운 엔티티로 인지하므로 매우 비효율적입니다. 따라서 Persistable을 사용해서 새로운 엔티티 확인 여부를 직접 구현하는 것이 효과적입니다.

참고로 등록 시간(@CreateDate)을 조합해서 사용하면 이 필드로 새로운 엔티티 여부를 편리하게 확인할 수 있습니다. (@CreateDate에 값이 없으면 새로운 엔티티로 판단합니다.)

Persistable 구현

Java
package study.datajpa.Entity;

import lombok.AccessLevel;
import lombok.Getter;
import lombok.NoArgsConstructor;
import org.springframework.data.annotation.CreatedDate;
import org.springframework.data.domain.Persistable;
import org.springframework.data.jpa.domain.support.AuditingEntityListener;

import javax.persistence.Entity;
import javax.persistence.EntityListeners;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import java.time.LocalDateTime;

@Entity
@Getter
@EntityListeners(AuditingEntityListener.class)
@NoArgsConstructor(access = AccessLevel.PROTECTED)
public class Item implements Persistable<String> {

    @Id @GeneratedValue
    private String id;

    public Item(String id) {
        this.id = id;
    }

    @CreatedDate
    private LocalDateTime createDate;

    @Override
    public boolean isNew() {
        return createDate == null;
    }
}

이 글은 인프런 김영한 님의 실전! 스프링 데이터 JPA을 들으며 정리한 노트입니다.

이 시리즈 · 스프링 데이터 JPA
전체 6편
06스프링 데이터 JPA는 어떻게 동작하는가 ← 지금 읽는 글

댓글

GitHub 계정으로 로그인하시면 댓글과 질문을 남기실 수 있습니다. 남겨 주신 글은 이 저장소의 Discussions에 쌓입니다.

● main 214 posts UTF-8 LF © 2026 코징 RSS · GitHub