[JPA] 페이징 정리 (JPA, Data JPA, QueryDSL)

 

 

클릭 시 이동합니다.

 

순수한 JPA

 

DATA JPA

 

QueryDSL

 

 

 

 

 

 

 

 

 

 

 

 

순수 JPA 에서의 페이징

 

다음 두 메서드를 통해 페이징을 진행합니다

 

• setFirstResult(int startPosition) : 조회 시작 위치, 0부터 시작합니다.
• setMaxResult(int maxResult) : 조회할 데이터 수

 

setFirstResult는 페이지의 번호가 아닌 조회를 시작할 row의 위치를 설정하는 것입니다.

 

 

 

예시 코드

em.createQuery("select m from Member m where m.age = :age order by m.username desc", Member.class)
                 .setParameter("age", age)
                 .setFirstResult(0)   //시작 위치 지정
                 .setMaxResult(10) //조회할 데이터 개수 지정
                 .getResultList();

 

 

 

 

 

 

 

 

페이지별 조회 방법

N번째 페이지의 시작 위치 :   $(\;N\;-\;1\;) \; \times \;$ 페이지 사이즈

 

첫번째 페이지를 조회하고 싶다면 setFirstResult()에 0을,

두번째 페이지를 조회하고 싶다면, [1 * 페이지 사이즈]를,

N페이지를 조회하고 싶다면 [(N-1) * pageSize]를 설정해 주면 됩니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Data JPA에서의 페이징

 

 

정렬을 위한 파라미터

org.springframework.data.domain.Sort 

정렬 기능을 제공합니다.

 

 

 

 

 

 

 

페이징을 위한 파라미터

org.springframework.data.domain.Pageable

페이징 기능과 내부에 Sort 포하하고 있기에 정렬 기능도 같이 제공합니다.

 

즉 Sort는 페이징 기능이 없고, Pageable은 Sort에 페이징 기능까지 추가된 것입니다.

Pageable의 구현체 PageRequest를 보면 Sort가 들어있는것을 알 수 있습니다.

 

 

 

 

 

 

 

 

 

반환 타입

• org.springframework.domain.Page
  • 추가 count 쿼리가 발생합니다.  
  • 현재 페이지에 대한 정보와, 전체 데이터의 개수를 조회합니다.
• org.springframework.domain.Slice
  •  추가 count 쿼리 없이 다음 페이지만 확인 가능합니다.
  • 내부적으로 limit +1을 조회하여 다음 페이지가 있는지 없는지만 확인합니다.
• List : 추가 count 쿼리 없이 결과만 반환합니다.

 

 

 

 

 

 

 

 

 

사용 방법

Page<Member> findByAge(int age, Pageable pageable); //count 쿼리 사용
Page<Member> findByAge(int age, Sort sort); //count 쿼리 사용

Slice<Member> findByAge(int age, Pageable pageable); //count 쿼리 사용안함
Slice<Member> findByAge(int age, Sort sort); //count 쿼리 사용안함

List<Member> findByAge(int age, Pageable pageable); //count 쿼리 사용안함
List<Member> findByAge(int age, Sort sort);

따로 코드 구현 없이, 인수를 넘겨주는 것만으로도 페이징 혹은 정렬이 가능합니다.

 

 

 

 

 

 

 

 

 

PageRequest - Pageable 구현체

PageRequest pageRequest = PageRequest.of(페이지, 페이징할 사이즈, Sort.by(Sort.Direction.DESC, "age"));

PageRequest pageRequest = PageRequest.of(0, 3, Sort.by(Sort.Direction.DESC, "age"));

 

0은 페이지, 3은 페이징할 사이즈입니다.

 

Sort 조건은 없어도 됩니다.

 

 

 

 

페이지는 0부터 시작하며, 순수 JPA의 setFirstResult와 달리 페이지 수를 직접 명시해줍니다.

 

 

 

 

 

 

예시

@Test
fun paging() {
    //given
    val member1 = Member(username = "member1", age = 1)
    val member2 = Member(username = "member2", age = 1)
    val member3 = Member(username = "member3", age = 1)
    val member4 = Member(username = "member4", age = 1)
    val member5 = Member(username = "member5", age = 1)
    val member6 = Member(username = "member6", age = 1)
    val member7 = Member(username = "member7", age = 1)
    val member8 = Member(username = "member8", age = 1)
    val member9 = Member(username = "member9", age = 1)
    val member10 = Member(username = "member10", age = 1)
    memberRepository.save(member1)
    memberRepository.save(member2)
    memberRepository.save(member3)
    memberRepository.save(member4)
    memberRepository.save(member5)
    memberRepository.save(member6)
    memberRepository.save(member7)
    memberRepository.save(member8)
    memberRepository.save(member9)
    memberRepository.save(member10)


    val pageRequest = PageRequest.of(1, 3, Sort.by(Sort.Direction.DESC, "username"))


    //when
    val findByUsername = memberRepository.findByAge(10, pageRequest)


    //then
    findByUsername.forEach{println(it)}
}

 

결과는 다음과 같습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

카운트 쿼리의 분리

카운트의 개수를 새어올 때 left 조인이 실행되는 경우와 그렇지 않은 경우는 결과 개수가 달라지지 않습니다.

즉 성능을 저하시키는 join 쿼리를 날릴 필요가 없는 것입니다.

 

 

따라서 JPA는 성능 최적화를 위해 카운트 쿼리를 분리하는 기능을 제공합니다.

public interface MemberRepository extends JpaRepository<Long, Member> {

    @Query(
        value = “select m from Member m left join m.team”, 
        countQuery = “select count(m.username) from Member m”)
    Page<Member> findMemberAllCountBy(Pageable pageable);
}

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

쿼리 DSL에서의 페이징

offset과 limit를 통해서 페이징을 수행합니다.

 

 

 

offset은 0부터 시작하며, 몇 번째 row에서 데이터 조회를 시작할지 정한다고 하였습니다.

 

limit는 한 화면에 보여줄 데이터의 개수입니다.

 

 

 

 

조회 건수 제한

/**
 * 페이지 처리
 * offset - 페이지 수가 아니라 row 수
 * limit - 몇개 가지고 올지
 */
@Test
fun testPaging() {
    //given

    val pageable = PageRequest.of(2, 3)

    println(pageable.offset)//page * size
    println(pageable.pageNumber)
    val content = query
        .selectFrom(member)
        .orderBy(member.age.asc())
        .offset(pageable.offset)
        .limit(pageable.pageSize.toLong())
        .fetch()
}

 

 

 

 

 

 

 

 

 

 

Data JPA + QueryDSL

 

 

Count 쿼리를 분리한 페이징 최적화

/**
 * 페이지 처리
 * offset - 페이지 수가 아니라 row 수
 * limit - 몇개 가지고 올지
 */
@Test
fun testPaging() {
    //given

    val pageable = PageRequest.of(2, 3)

    println(pageable.offset)//page * size
    println(pageable.pageNumber)
    val content = query
        .selectFrom(member)
        .orderBy(member.age.asc())
        .offset(pageable.offset)
        .where(/** 조건 */)
        .limit(pageable.pageSize.toLong())
        .fetch()

    val countQuery = query
        //.select(Wildcard.count)   ->  select count(*)
        .select(member.count())
        .from(member)
        .where(/** 조건 */)

    val page: Page<Member> = PageableExecutionUtils.getPage(content, pageable) { countQuery.fetchOne()!! }


    assertThat(page.size).isEqualTo(pageable.pageSize)//몇개씩 잘라서 페이징 하였는가
    assertThat(page.totalPages).isEqualTo(4)//전체 페이지 수
    assertThat(page.totalElements).isEqualTo(12)//전체 존재하는 회원 수
    assertThat(page.number).isEqualTo(pageable.pageNumber)
    assertThat(page.numberOfElements).isEqualTo(3)//해당 패이지에 존재하는 원소의 개수
    assertThat(page.content[0].username).isEqualTo("member7")
}

 

Querydsl의 fetchResults() , fetchCount()는 5.0 버전 이후부터 Deprecated 되었습니다.

따라서 count 쿼리가 필요한 경우 위의 예시처럼 작성하여야 합니다.

PageableExecutionUtils.getPage() 를 사용하였는데, 이는 스프링 Data 라이브러리가 제공합니다.

 

페이지의 시작이면서 컨텐츠 사이즈가 페이지 사이즈보다 작거나,

마지막 페이지인 경우에는 count쿼리를 생략해서 처리합니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Spring Data JPA + QueryDSL + MVC Controller

스프링 데이터 JPA를 사용하면, Controller를 통해 Pagable 객체를 바로 받을 수 있으며, 그 방법은 다음과 같습니다.

Controller 설정

?page=2&size=5

 

 

 

위의 예시에서는 다음과 같은 Pagable이 반환된다.

• pageable.getOffset() -> 10
• pageable.getPageNumber() -> 2
• pageable.getPageSize=5;

 

 

 

 

 

 

 

Offset 계산

offset은 페이지의 번호가 아니라, 데이터를 조회하기 시작할 row의 위치입니다.(0부터 시작)

 

따라서 페이지의 사이즈가 5이고, 0번째 페이지를 조회하고 싶다면 offset은 0, 

1번째 페이지를 조회하고 싶다면 5,

2번째 페이지를 조회하고 싶다면 10,

이런 식으로 반환되어야 하는 것입니다.

 

 

 

실제로 Pageable을 구현한 추상 클래스인 AbstractPageRequest를 보면 다음과 같습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Reference

자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의

[자바 ORM 표준 JPA 프로그래밍 - 김영한]

실전! Querydsl - 인프런 | 강의

 

실전! 스프링 데이터 JPA - 인프런 | 강의