PageResponse.java

역할

• Spring Data JPA Page<T> 객체를 프론트 전달용으로 변환하는 공통 페이징 DTO

1. 핵심 구조: PageResponse record

public record PageResponse<T>(
        List<T> content,     // 실제 데이터 목록
        int page,            // 현재 페이지 번호 (0부터 시작)
        int size,            // 페이지 크기
        long totalElements,  // 전체 데이터 수
        int totalPages,      // 전체 페이지 수
        boolean first,       // 첫 페이지 여부
        boolean last         // 마지막 페이지 여부
) {

    // Page<T> → PageResponse<T> 변환 팩토리 메서드
    public static <T> PageResponse<T> from(Page<T> p) {
        return new PageResponse<>(
                p.getContent(),
                p.getNumber(),
                p.getSize(),
                p.getTotalElements(),
                p.getTotalPages(),
                p.isFirst(),
                p.isLast()
        );
    }
}

2. 설명

변환 흐름

Spring Data JPA Page<T> 객체
        │
        ▼
PageResponse.from(Page<T>) 호출
        │
        ▼
PageResponse<T> 객체 생성
        │
        ▼
프론트엔드 전달

• Page<T>: JPA가 반환하는 페이징 결과 객체
• PageResponse<T>: 프론트가 쉽게 처리할 수 있는 JSON 형태로 변환
• from(Page<T> p) 정적 메서드로 간단 변환

3. 포인트

• Record 사용 → 불변(immutable) DTO, 생성자/Getter 자동 제공
• 모든 페이지 정보 포함: 데이터, 페이지 번호, 페이지 크기, 전체 요소 수, 전체 페이지 수, 첫/마지막 페이지 여부
• 프론트는 이 DTO만 보고 페이지 UI 구성 가능

<aside> 💡

Tip

• API 응답 표준화: 다른 리스트 API도 동일 구조 사용 가능
• 필요 시 sort, hasNext, hasPrevious 등 추가 정보 포함 가능
• Page<T> 객체를 그대로 반환하지 않고 DTO로 변환 → 프론트 의존 최소화 + 보안 </aside>