🔎 Overview

  백엔드 개발자들은 아마 절대다수가 CRUD를 통한 게시판 만들기 프로젝트를 진행한 경험이 있을 것이다.
  필자도 마찬가지로 CRUD를 통한 게시판 만들기를 진행하던 도중, 이상하게 헷갈리던 개념이 있었다.
바로 페이징 작업이다.

  그당시에는 지금보다도 훨씬 더 프로그래밍과 자바에 대한 지식이 적었다.
  그러다보니 기존 지식으로 어느정도 해결할 수 있는 기초적인 CRUD 작업을 하는 것은 크게 어렵지 않았지만, 처음으로 페이징 작업을 직면했을 때 땀을 뻘뻘 흘리며 고전했던 기억이 있다.

  지금은 그때처럼 페이징 작업에 대한 어려움이 없지만, 자주 써서 익숙해진 느낌이지 Page에 대한 개념을 자세히 아느냐고 스스로에게 물어보면 그 대답은 'No'에 가깝다.

  그러므로 내친김에 Page를 확실하게 정리해보고자 이번 포스팅을 진행하게 되었다.

---

📕 Page 객체

• 페이징 작업에 사용되는 데이터 구조
• Page 와 Pageable 인터페이스를 통해 페이징 처리를 쉽게 할 수 있음
• DB 쿼리 결과를 페이징 처리할 때 유용하게 사용
• Spring Data JPA 에서 제공하는 org.springframework.data.domain.Page 를 import하여 사용
  
  
  

📑 Page 주요 구성 요소

1) 데이터 관련

• getContent()
  • 현재 페이지에 포함된 데이터 리스트 반환
  • 페이징 처리 된 데이터
• getSize()
  • 한 페이지 당 데이터 개수
• getNumber()
  • 현재 페이지 번호 (0부터 시작하므로 적당한 조작 필요)
• getTotalElement()
  • 페이징 처리 된 전체 데이터 개수
• getTotalPages()
  • 페이징 처리 된 전체 페이지 개수
    
    

2) 페이징 상태 관련

• hasNext()
  • 다음 페이지가 존재하는지 여부
• hasPrevious()
  • 이전 페이지가 존재하는지 여부
• isFirst()
  • 현재 페이지가 첫 페이지인지 여부
• isLast()
  • 현재 페이지가 마지막 페이지인지 여부
    
    
    

⏰ Page 사용 시기

1) 대량 데이터 조회

• 데이터가 많아서, DB 에서 데이터를 한 번에 가져오는 것보다 페이지 단위로 효율적으로 잘라서 조회하는 것이 좋을 때 사용

2) 웹 애플리케이션 페이징 처리

• 프론트엔드에서 pagination UI를 제공하기 위해서, 서버에서 데이터를 페이지 단위로 제공해야 할 때 사용

3) REST-API 응답

• 클라이언트가 데이터를 페이지별로 요청하여, 적합한 방식으로 응답해야 할 때 사용

---

📝 Pageable 과 PageRequest

1️⃣ Pageable

• 페이징 정보를 추상화한 인터페이스
• 페이징 처리에 필요한 데이터를 제공
• PageRequest 클래스를 통해 이를 구현

// 주요 메서드
public interface Pageable {
	int getPageNumber();		// 현재 페이지 번호 반환 (0부터 시작)
    int getPageSize();			// 페이지 당 데이터 개수
    int getOffset();			// 페이징 시작 위치 (pageNumber * pageSize)
    Sort getSort();				// 현재 정렬 정보 반환 (Sort 객체)
    Pageable next();			// 다음 페이지의 Pageable 객체 반환
    Pageable previousOrFirst();	// 이전 페이지의 Pageable 객체, 혹은 첫 페이지를 반환
    Pageable first();			// 첫 페이지의 Pageable 객체 반환
    boolean hasPrevious();		// 이전 페이지 존재 여부 반환
}

2️⃣ PageRequest

• Pageable 인터페이스의 구현체
• 실제 페이징 정보를 생성할 때 사용
• 정렬 정보도 함께 설정 가능

public class myPageRequest {
	int page = 0, size = 10;
    
	// 페이지당 10개씩, 1페이지 페이징 (pageNumber는 0부터 시작하므로)
	PageRequest pageRequest = PageRequest.of(page, size);

	// 페이징 + "id"를 기준으로 오름차순 정렬 (1)
    Sort sort = Sort.by("id").ascending();
	pageRequest = PageRequest.of(page, size, sort);
    
    // 페이징 + "id"를 기준으로 오름차순 정렬 (2)
    pageRequest = PageRequest.of(page, size, Sort.by(Sort.Order.asc("id")));
    
    // 페이징 + "id"를 기준으로 내림차순 정렬 (1)
    sort = Sort.by("id").descending();
    pageRequest = PageRequest.of(page, size, sort);
    
    // 페이징 + "id"를 기준으로 내림차순 정렬 (2)
    pageRequest = PageRequest.of(page, size, Sort.by(Sort.Order.desc("id")));
}

---

💡 Page 객체 스스로 만들어보기

@Getter
public class MyPage<T> {
	private List<T> content;		// 페이징 된 데이터
    private int pageNumber;			// 현재 페이지 번호
    private int pageSize;			// 페이지 당 데이터 수
    private int totalItems;			// 총 데이터 수
    private int totalPages;			// 총 페이지 수
    private boolean isFirst;		// 첫 번째 페이지인지 여부
    private boolean isLast;			// 마지막 페이지인지 여부
    
    public MyPage(List<T> content, int pageNumber, int pageSize, int totalItems) {
    	this.content = content;
        this.pageNumber = pageNumber;
        this.pageSize = pageSize;
        this.totalItems = totalItems;
        this.totalPages = (int) Math.ceil((double) totalItems / pageSize);
        this.isFirst = pageNumber == 0;
        this.isLast = pageNumber == totalPages - 1;
    }
}

---

참고) OpenAI. (2024).ChatGPT(4o)[Large language model].https://chatgpt.com/