🐌 “내 Spring Boot API가 느려졌어요… Pagination & Sorting을 배우기 전까지”

Source: Dev.to

정렬 및 페이지네이션이 중요한 이유

실제 애플리케이션에서는:

• 데이터베이스가 빠르게 성장한다
• 한 번에 모든 데이터를 가져오는 것은 비용이 많이 든다
• 클라이언트는 전체 데이터를 거의 필요로 하지 않는다

정렬과 페이지네이션을 사용하면:

• 성능 향상
• 메모리 사용량 감소
• 더 빠른 API 제공
• 확장 가능한 시스템 구축

이는 프로덕션 백엔드에서는 선택 사항이 아니다.

메서드 쿼리 이름을 이용한 정렬

Spring Data JPA는 메서드 이름에 직접 정렬을 지정할 수 있다.

List findAllByOrderByNameAsc();
List findAllByOrderByNameDesc();

다음과 같은 경우에 잘 동작한다:

• 정렬 로직이 고정돼 있을 때
• 요구사항이 단순할 때

하지만 실제 애플리케이션에서는 동적 정렬이 필요하다.

Sort 클래스를 이용한 동적 정렬

레포지토리 메서드와 함께 사용하는 정렬

List findByDepartment(String department, Sort sort);

이를 통해 클라이언트가 결정할 수 있다:

• 어떤 필드로 정렬할지
• 오름차순 또는 내림차순

Sort 객체 생성

Sort sort = Sort.by(Sort.Direction.ASC, sortField);

여러 정렬 필드 지정:

Sort sort = Sort.by(
    Sort.Order.asc("name"),
    Sort.Order.desc("salary")
);

정렬만으로는 부족한 이유

정렬을 적용하더라도:

• 수천 개의 행을 반환하는 것은 비효율적이다
• API가 느려진다
• 클라이언트가 큰 응답을 처리하기 힘들다

이때 페이지네이션이 필요하다.

페이지네이션 이해하기

핵심 페이지네이션 개념

Page

데이터의 한 조각을 나타내며 다음 정보를 포함한다:

• 전체 요소 수
• 전체 페이지 수
• 현재 페이지 데이터

Pageable

다음 항목을 정의한다:

• 페이지 번호
• 페이지 크기
• 정렬 규칙

PageRequest

Pageable의 구체적인 구현으로, 페이지네이션 객체를 생성할 때 사용한다.

레포지토리에서 Pageable 사용하기

Spring Data JPA는 페이지네이션을 매우 간단하게 만든다.

Page findAll(Pageable pageable);
Page findByLastName(String lastName, Pageable pageable);

SQL도 없고 복잡한 로직도 없다. 깔끔한 메서드 시그니처만 있으면 된다.

Pageable 인스턴스 만들기

Pageable pageable = PageRequest.of(
    pageNumber,
    size,
    Sort.by("lastName").ascending()
);

이를 통해 제어할 수 있는 것은:

• 페이지 크기
• 페이지 번호
• 정렬

모두 하나의 객체에 담는다.

내가 저지른 실수

예전에는:

• 모든 레코드를 가져옴
• 메모리 내에서 정렬함
• 확장성을 무시함

데이터가 증가할 때까지는 동작했지만, 페이지네이션과 정렬을 도입한 뒤:

• API가 빨라졌다
• 메모리 사용량이 감소했다
• 백엔드가 프로덕션 수준이 되었다

마무리 생각

정렬과 페이지네이션은 “부가 기능”이 아니다. 핵심 백엔드 기본이다. 만약 Spring Boot API가 다음과 같은 문제를 보인다면:

• 느림
• 무거움
• 확장 어려움

여기서부터 시작하라.

이 글은 Spring Boot과 실제 백엔드 개발을 탐구하면서 진행한 learning-in-public 여정의 일부이다.