Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

Spring Data JPA 학습 프로젝트

Spring Data JPA의 핵심 기능을 직접 구현하고 비교하며 학습하는 프로젝트입니다. 순수 JPA(EntityManager)와 Spring Data JPA 방식을 나란히 구현해 두 방식의 차이를 명확하게 이해할 수 있습니다.

기술 스택

항목 버전
Java 17
Spring Boot 3.4.0
Spring Data JPA (Boot 관리)
Hibernate (Boot 관리)
H2 Database in-memory / TCP 서버 모드
Lombok (Boot 관리)

학습 내용

1. 레포지토리 두 가지 방식 비교

순수 JPA Spring Data JPA
MemberJpaRepository MemberRepository
TeamJpaRepository TeamRepository
EntityManager 직접 사용 JpaRepository 인터페이스 상속

2. 쿼리 작성 방법

  • 메서드 이름으로 쿼리 생성: findByUsernameAndAgeGreaterThan()
  • @NamedQuery: 엔티티에 정의한 이름 있는 쿼리 사용
  • @Query: JPQL을 직접 작성
  • @Query + DTO 프로젝션: new 키워드로 DTO 직접 반환
// 메서드 이름 파생 쿼리
List<Member> findByUsernameAndAgeGreaterThan(String username, int age);

// 직접 JPQL 작성
@Query("select new study.datajpa.dto.MemberDto(m.id, m.username, t.name) from Member m join m.team t")
List<MemberDto> findMemberDto();

3. 반환 타입

List<Member> findListByUsername(String name);          // 컬렉션 (없으면 빈 리스트)
Member findMemberByUsername(String name);              // 단건 (없으면 null)
Optional<Member> findOptionalByUsername(String name);  // Optional

4. 페이징 & 정렬

  • 순수 JPA: setFirstResult(), setMaxResults()로 직접 처리
  • Spring Data JPA: Pageable / Page<T> 인터페이스로 자동 처리
    • Page.getTotalElements(), getTotalPages(), isFirst(), hasNext() 등 제공
    • count 쿼리 분리로 성능 최적화 가능
@Query(value = "select m from Member m where m.age = :age",
       countQuery = "select count(m) from Member m where m.age = :age")
Page<Member> findByAge(@Param("age") int age, Pageable pageable);

5. 벌크 업데이트 (@Modifying)

@Modifying(clearAutomatically = true)
@Query("update Member m set m.age = m.age + 1 where m.age >= :age")
int bulkAgePlus(@Param("age") int age);

clearAutomatically = true: 벌크 연산 후 영속성 컨텍스트를 자동으로 초기화하여 데이터 정합성 보장

6. N+1 문제 해결

방법 설명
Fetch Join (@Query) JPQL에 left join fetch 작성
@EntityGraph 어노테이션으로 페치 조인 적용 (간편)
// Fetch Join
@Query("select m from Member m left join fetch m.team")
List<Member> findMemberFetchJoin();

// EntityGraph
@Override
@EntityGraph(attributePaths = {"team"})
List<Member> findAll();

7. 성능 최적화

// 읽기 전용 힌트 - 스냅샷 생성 안 함 → 변경 감지 생략
@QueryHints(value = @QueryHint(name = "org.hibernate.readOnly", value = "true"))
Member findReadOnlyByUsername(String username);

프로젝트 구조

src
├── main
│   ├── java/study/datajpa
│   │   ├── DataJpaApplication.java
│   │   ├── controller
│   │   │   └── HelloController.java
│   │   ├── dto
│   │   │   └── MemberDto.java
│   │   ├── entity
│   │   │   ├── Member.java          # @ManyToOne (LAZY), @NamedQuery
│   │   │   └── Team.java            # @OneToMany (mappedBy)
│   │   └── repository
│   │       ├── MemberJpaRepository.java   # 순수 JPA
│   │       ├── MemberRepository.java      # Spring Data JPA
│   │       ├── TeamJpaRepository.java     # 순수 JPA
│   │       └── TeamRepository.java        # Spring Data JPA
│   └── resources
│       └── application.yml          # H2 TCP 서버 모드 (포트 8888)
└── test
    ├── java/study/datajpa
    │   ├── entity
    │   │   └── MemberTest.java
    │   └── repository
    │       ├── MemberJpaRepositoryTest.java
    │       └── MemberRepositoryTest.java
    └── resources
        └── application.yml          # 테스트용 H2 인메모리 모드

실행 방법

애플리케이션 실행

application.yml은 H2를 TCP 서버 모드로 연결합니다. 앱 실행 전 H2 서버를 먼저 기동해야 합니다.

  1. H2 Console을 열고 "Generic H2 (Server)" 모드로 연결 (jdbc:h2:tcp://localhost/~/datajpa)
  2. 또는 H2 jar 직접 실행:
    java -jar h2-*.jar
  3. 애플리케이션 실행:
    ./gradlew bootRun
  4. 접속: http://localhost:8888

테스트 실행

테스트는 인메모리 H2를 사용하므로 별도 서버 없이 바로 실행됩니다.

./gradlew test

엔티티 관계

Team (1) ──── (*) Member
  id               id
  name             username
  members          age
                   team (FK: team_id)
  • Member → Team: @ManyToOne(fetch = LAZY) (지연 로딩)
  • Team → Member: @OneToMany(mappedBy = "team") (양방향)
  • changeTeam() 메서드로 양방향 관계 편의 메서드 구현

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages