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 관리) |
| 순수 JPA | Spring Data JPA |
|---|---|
MemberJpaRepository |
MemberRepository |
TeamJpaRepository |
TeamRepository |
| EntityManager 직접 사용 | JpaRepository 인터페이스 상속 |
- 메서드 이름으로 쿼리 생성:
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();List<Member> findListByUsername(String name); // 컬렉션 (없으면 빈 리스트)
Member findMemberByUsername(String name); // 단건 (없으면 null)
Optional<Member> findOptionalByUsername(String name); // Optional- 순수 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);@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: 벌크 연산 후 영속성 컨텍스트를 자동으로 초기화하여 데이터 정합성 보장
| 방법 | 설명 |
|---|---|
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();// 읽기 전용 힌트 - 스냅샷 생성 안 함 → 변경 감지 생략
@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 서버를 먼저 기동해야 합니다.
- H2 Console을 열고 "Generic H2 (Server)" 모드로 연결 (
jdbc:h2:tcp://localhost/~/datajpa) - 또는 H2 jar 직접 실행:
java -jar h2-*.jar - 애플리케이션 실행:
./gradlew bootRun
- 접속: http://localhost:8888
테스트는 인메모리 H2를 사용하므로 별도 서버 없이 바로 실행됩니다.
./gradlew testTeam (1) ──── (*) Member
id id
name username
members age
team (FK: team_id)
Member→Team:@ManyToOne(fetch = LAZY)(지연 로딩)Team→Member:@OneToMany(mappedBy = "team")(양방향)changeTeam()메서드로 양방향 관계 편의 메서드 구현