Paginacja, sortowanie i projekcje
Proszę zwracać stronicowane wyniki za pomocą Pageable, dynamicznie sortować dane i używać projekcji interfejsowych, aby ograniczyć pobierane kolumny.
Paginacja, sortowanie i projekcje to bezpłatna lekcja Java Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Java Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Java Academy zawiera 4 lekcji w sumie.
Po co stosować stronicowanie?
Zwracanie tysięcy wierszy w jednym zapytaniu niepotrzebnie zużywa pamięć i przepustowość. Stronicowanie ładuje dane po jednej stronie. Spring Data integruje stronicowanie za pomocą abstrakcji Pageable.
Pageable i PageRequest
Obiekt Pageable należy utworzyć za pomocą PageRequest.of(page, size). Następnie należy przekazać go do dowolnej metody repozytorium zwracającej Page<T>.
Pageable pageable = PageRequest.of(0, 20); // page 0, 20 per page
Page<User> page = userRepo.findAll(pageable);
System.out.println("Total: " + page.getTotalElements());
System.out.println("Pages: " + page.getTotalPages());
System.out.println("Content: " + page.getContent().size());Sortowanie za pomocą PageRequest
Do PageRequest można dodać sortowanie za pomocą obiektu Sort. Wiele pól można połączyć za pomocą Sort.by().and().
Pageable sorted = PageRequest.of(0, 20,
Sort.by(Sort.Direction.DESC, "createdAt")
.and(Sort.by("name")));
Page<User> page = userRepo.findAll(sorted);Slice a Page
Page<T> wykonuje zapytanie COUNT w celu obliczenia całkowitej liczby stron. Slice<T> tego nie robi — informuje tylko, czy istnieje następna strona. Należy używać Slice w przypadku nieskończonego przewijania, gdy całkowita liczba elementów nie jest potrzebna.
public interface UserRepository extends JpaRepository<User, Long> {
Slice<User> findByStatus(UserStatus status, Pageable pageable);
}Integracja ze Spring MVC
Spring MVC automatycznie tworzy obiekt Pageable na podstawie parametrów zapytania: ?page=0&size=20&sort=name,asc. Ręczne analizowanie parametrów nie jest potrzebne.
@GetMapping("/users")
public Page<UserDto> list(Pageable pageable) {
return userRepo.findAll(pageable).map(UserDto::from);
}
// GET /users?page=0&size=10&sort=name,ascProjekcje interfejsowe
Należy zdefiniować interfejs z metodami getter, których nazwy odpowiadają nazwom pól encji. Spring Data zwróci tylko te kolumny, ograniczając transfer danych i ukrywając szczegóły implementacji.
public interface UserSummary {
Long getId();
String getName();
String getEmail();
}
List<UserSummary> findByStatus(UserStatus status);Projekcje oparte na klasach (DTO)
Należy użyć rekordu DTO lub klasy z konstruktorem. Spring Data wygeneruje wyrażenie konstruktora JPQL dla wybranych kolumn.
public record UserDto(Long id, String name, String email) {}
@Query("SELECT new com.example.UserDto(u.id, u.name, u.email) FROM User u WHERE u.status = :s")
List<UserDto> findSummaries(@Param("s") UserStatus status);Projekcje dynamiczne
Typ projekcji należy przekazać jako parametr generyczny do metody repozytorium, aby wybrać projekcję w miejscu wywołania.
public interface UserRepository extends JpaRepository<User, Long> {
<T> List<T> findByStatus(UserStatus status, Class<T> type);
}
// Usage:
List<UserSummary> summaries = repo.findByStatus(ACTIVE, UserSummary.class);
List<User> full = repo.findByStatus(ACTIVE, User.class);Stronicowanie keysetowe (offsetowe a keysetowe)
Stronicowanie offsetowe (OFFSET N) działa coraz gorzej przy dużych wartościach offsetu. Stronicowanie keysetowe (z użyciem WHERE id > lastSeenId) ma złożoność O(1) niezależnie od głębokości strony, dlatego lepiej nadaje się do głębokiego stronicowania.
// Keyset pagination:
@Query("SELECT u FROM User u WHERE u.id > :lastId ORDER BY u.id LIMIT :size")
List<User> findPage(@Param("lastId") Long lastId, @Param("size") int size);Optymalizacja całkowitej liczby elementów
Należy użyć countQuery w @Query, aby zdefiniować zoptymalizowane zapytanie zliczające i uniknąć kosztownych JOIN-ów w głównym zapytaniu.
@Query(value = "SELECT u FROM User u JOIN FETCH u.orders WHERE u.status = :s",
countQuery = "SELECT COUNT(u) FROM User u WHERE u.status = :s")
Page<User> findActiveWithOrders(@Param("s") UserStatus s, Pageable p);Zwracanie ResponseEntity z metadanymi strony
W odpowiedzi REST należy uwzględnić metadane strony (totalElements, totalPages, number, size), aby klienci wiedzieli, jak nawigować między stronami.
@GetMapping("/users")
public ResponseEntity<Map<String, Object>> list(Pageable p) {
Page<UserDto> page = repo.findAll(p).map(UserDto::from);
return ResponseEntity.ok(Map.of(
"content", page.getContent(),
"totalElements", page.getTotalElements(),
"totalPages", page.getTotalPages()
));
}Szybkie sprawdzenie
Jaka jest kluczowa różnica między Page a Slice?
Podsumowanie
Należy używać Pageable+PageRequest.of() do stronicowania offsetowego. Spring MVC tworzy obiekt Pageable na podstawie parametrów zapytania. Należy używać Slice, aby uniknąć zapytania COUNT. Projekcje interfejsowe lub DTO pozwalają ograniczyć liczbę pobieranych kolumn. W przypadku dużych wartości offsetu należy stosować stronicowanie keysetowe.
Często zadawane pytania
Czy lekcja „Paginacja, sortowanie i projekcje” jest bezpłatna?
Tak — pełny tekst „Paginacja, sortowanie i projekcje” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Java Academy, przejdź na CoddyKit PRO. Kurs Java Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Paginacja, sortowanie i projekcje”?
Proszę zwracać stronicowane wyniki za pomocą Pageable, dynamicznie sortować dane i używać projekcji interfejsowych, aby ograniczyć pobierane kolumny. Ćwiczysz Java Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Java Academy?
Nie wymagamy żadnego doświadczenia. Java Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Paginacja, sortowanie i projekcje”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Java Academy?
Tak. Każda lekcja Java Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Mapowanie encji za pomocą adnotacji JPA
- Repozytoria Spring Data i metody zapytań
- Relacje jeden-do-wielu i wiele-do-wielu
- Paginacja, sortowanie i projekcje