SpringのPageableとSortでページング一覧APIを最短実装！初心者向け完全ガイド

1. Pageableとは？ページング処理の基本

「1. Pageableとは？ページング処理の基本」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. Pageableとは？ページング処理の基本

Spring FrameworkやSpring Bootで大量のデータを扱う際、データベースにある全レコードを一度に取得して画面に表示しようとすると、読み込みに時間がかかりすぎてしまいます。例えば、数万件のデータがある通販サイトで、全商品を1ページに表示しようとしたら、ブラウザが固まってしまいますよね。

これを解決するのがページング（Pagination）という技術です。本をページごとにめくるように、データを「1ページ10件ずつ」といった単位で分割して取得します。Springでは、このページ分割のルールを管理するためにPageableというインターフェースが用意されています。

具体的には、URLの末尾にクエリパラメータを付けるだけで、Springが自動的に「何件目から何件取得するか」を計算してくれます。

http://localhost:8080/api/books?page=0&size=5

このように、page（ページ番号 ※0から開始）、size（1ページあたりの件数）、sort（並び替え条件）という3つの要素を組み合わせることで、ユーザーにとって見やすく、サーバーに負担をかけない高速なAPIを簡単に構築できるのがPageableの最大のメリットです。

2. Spring Data JPAでPageableを使う方法

2. Spring Data JPAでPageableを使う方法

Spring Data JPAの最大の魅力は、複雑なSQLクエリを書かなくても、メソッドの引数にPageableを追加するだけでページング処理が完成する点にあります。通常、SQLでページングを行うには「LIMIT」や「OFFSET」を手動で計算して記述する必要がありますが、Spring Data JPAがその計算をすべて代行してくれます。

まずは、データベースを操作するRepository（リポジトリ）の設定です。JpaRepositoryを継承していれば、標準的なfindAll(Pageable pageable)は既に利用可能な状態になっています。

public interface BookRepository extends JpaRepository<Book, Long> {
    // Pageableを引数に渡すと、自動的にページング用SQLが発行される
    Page<Book> findAll(Pageable pageable);
}

次に、外部からのリクエストを受け取るController（コントローラー）を実装します。ここで注目すべきは、Pageableを引数に書くだけで、Springがブラウザからのパラメータ（pageやsize）を自動で解析してオブジェクト化してくれる仕組みです。

@RestController
@RequestMapping("/books")
public class BookController {

    private final BookRepository bookRepository;

    public BookController(BookRepository bookRepository) {
        this.bookRepository = bookRepository;
    }

    @GetMapping
    public Page<Book> getBooks(Pageable pageable) {
        // 受け取ったpageableをそのままリポジトリに渡すだけ！
        return bookRepository.findAll(pageable);
    }
}

この実装だけで、例えば /books?page=0&size=5 というURLにアクセスすると、データベースの1件目から5件目までをスマートに取得できます。もしパラメータを何も指定しなかった場合は、Spring Bootの標準設定（通常は1ページ20件など）が適用されるため、エラーになる心配もありません。

このように、開発者は「どのデータを何件取得するか」というビジネスロジックに集中でき、面倒な計算処理はフレームワークに任せることができるのです。

3. Sortを使った並び順の変更

3. Sortを使った並び順の変更

ページングとセットで欠かせないのがソート（並び替え）機能です。SpringではSortクラスを利用することで、データベースから取得するデータの順番を自由自在にコントロールできます。

使い方は非常にシンプルです。URLのパラメータにsort=フィールド名,方向を付け加えるだけで、Spring Data JPAが自動的にSQLのORDER BY句を生成してくれます。方向には、昇順（小さい順）のascと、降順（大きい順）のdescが指定可能です。

例えば、本のリストを「出版日が新しい順（降順）」で取得したい場合は、以下のようなリクエストになります。

http://localhost:8080/books?page=0&size=10&sort=publishedDate,desc

また、複数の条件を組み合わせることも可能です。例えば「著者名で並び替えて、同じ著者の場合はID順にする」といった複雑な指定も、パラメータを繋げるだけで実現できます。

http://localhost:8080/books?sort=author,asc&sort=id,desc

このようにPageableの中にSortの情報が含まれているため、Controller側で特別な処理を追加することなく、呼び出し側のURLを変えるだけで並び順を柔軟に変更できるのがこの仕組みの強みです。

4. デフォルト値の指定やバリデーションを加える方法

「4. デフォルト値の指定やバリデーションを加える方法」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. デフォルト値の指定やバリデーションを加える方法

Webアプリを公開すると、ユーザーが常にすべてのパラメータ（pageやsizeなど）を入力してくれるとは限りません。何も指定がない場合に「1ページに何件表示するか」という初期設定（デフォルト値）を決めておくことは、システムの安定稼働において非常に重要です。

Springでは@PageableDefaultアノテーションを使用することで、コントローラー層で簡単にデフォルト値を設定できます。

@GetMapping("/books/default")
public Page<Book> getBooksDefault(
        @PageableDefault(
            page = 0,               // デフォルトのページ番号（0から開始）
            size = 5,               // 1ページあたりの表示件数
            sort = "title",         // ソート対象のフィールド
            direction = Sort.Direction.ASC // 昇順（小さい順）に設定
        ) Pageable pageable) {
    
    return bookRepository.findAll(pageable);
}

また、実務レベルではバリデーション（入力値チェック）も意識する必要があります。例えば、悪意のあるユーザーが「size=1000000」といった巨大な数値を指定してサーバーに負荷をかける攻撃を防ぐために、設定ファイル（application.properties）で最大取得件数を制限するなどの対策をセットで行うのがSEO的にもユーザー体験的にも優良な設計といえます。

このようにデフォルト値を適切に設定しておくことで、クエリパラメータが省略された場合でも、システムがクラッシュすることなく常に安定したレスポンスを返すことが可能になります。

5. ページングレスポンスの中身を理解しよう

5. ページングレスポンスの中身を理解しよう

Page<T>型の戻り値には、対象のデータだけでなく、ページ全体に関するメタ情報も含まれています。

• content：現在のページのデータリスト
• totalElements：全件数
• totalPages：総ページ数
• number：現在のページ番号
• size：ページサイズ
• first / last：先頭ページか末尾ページかの判定

この情報を使えば、「次へ」「前へ」などのページネーションリンクも実装しやすくなります。

6. REST APIでページングとソートを活用する実例

6. REST APIでページングとソートを活用する実例

実務では、検索や一覧画面において、ページングとソートを同時に扱うことが一般的です。

Spring BootでREST APIを作成する際は、以下のようなリクエストURLが実際に使われます。

/books?page=2&size=20&sort=author,desc

APIの戻り値はJSON形式で、フロントエンドに渡しやすく、AngularやReact、Vue.jsなどとも相性抜群です。

7. ページングとソートをカスタムクラスに変換する

「7. ページングとソートをカスタムクラスに変換する」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. ページングとソートをカスタムクラスに変換する

Page<T>はそのままだと使いにくい場合もあるため、レスポンスを独自DTO（Data Transfer Object）に変換するのもおすすめです。

例えば、以下のようなレスポンス構造に変換できます：

public class BookPageResponse {
    private List<BookDto> content;
    private int currentPage;
    private int totalPages;
    private long totalElements;
    // getter/setter 略
}

8. PageableとSortを使うときの注意点

8. PageableとSortを使うときの注意点

最後に、ページングとソートを使う際のよくある落とし穴を整理しておきます。

• ソート対象のフィールド名が間違っていると実行時エラーになる
• デフォルトページサイズが大きすぎるとレスポンスが重くなる
• ソート条件がユーザー入力のままだとSQLインジェクションの可能性も

こうしたリスクを避けるには、制限を設ける・ログ出力を強化する・明示的なバリデーションを加えることが推奨されます。

まとめ

まとめ

本記事では、Spring Bootにおいて非常に強力なツールであるPageableとSortを用いた、ページング一覧APIの実装方法について詳しく解説してきました。WebアプリケーションやモダンなSPA（Single Page Application）を構築する際、大量のデータを一度に取得してクライアントに返却することは、サーバー負荷の増大やネットワーク帯域の圧迫、そしてユーザー体験（UX）の低下を招く大きな要因となります。そのため、実務レベルの開発において、適切なページング処理とソート機能の実装は避けて通れない必須スキルと言えるでしょう。

ページング実装の重要性とSEO効果

検索エンジン最適化（SEO）の観点からも、ページングは非常に重要です。大量のコンテンツを適切に分割し、関連性の高いデータを上位に表示させることは、クローラーの巡回効率を高め、ユーザーが必要な情報に素早くアクセスできる環境を提供することに直結します。JavaのSpring Frameworkが提供するPageableインターフェースを利用することで、開発者は複雑なSQLのLIMIT句やOFFSET句を直接記述することなく、オブジェクト指向的なアプローチでこれらの機能を統合できます。

サンプルプログラム：より実践的なサービス層での活用

これまでの章ではリポジトリとコントローラーの連携を見てきましたが、ここでは実際のビジネスロジックを想定し、サービス層（Service Layer）を介したより堅牢な実装サンプルを紹介します。DTO（Data Transfer Object）への変換処理も含めることで、APIの外部仕様とデータベースのエンティティ構造を分離し、保守性の高いコードを実現します。

@Service
@Transactional(readOnly = true)
public class BookService {

    private final BookRepository bookRepository;

    public BookService(BookRepository bookRepository) {
        this.bookRepository = bookRepository;
    }

    /**
     * 書籍一覧をページング形式で取得し、DTOに変換して返却します。
     * @param pageable ページング情報
     * @return 変換済みのページオブジェクト
     */
    public Page<BookResponseDto> findAllBooks(Pageable pageable) {
        // RepositoryからエンティティのPageを取得
        Page<Book> bookPage = bookRepository.findAll(pageable);
        
        // エンティティからDTOへ変換（mapメソッドを活用）
        return bookPage.map(book -> new BookResponseDto(
                book.getId(),
                book.getTitle(),
                book.getAuthor(),
                book.getPublishedDate()
        ));
    }
}

このように、Page.map()メソッドを使用することで、ページングのメタ情報を維持したまま、中身のコンテンツだけをスマートに変換することが可能です。これは、APIレスポンスのセキュリティを確保し、必要なフィールドのみを公開する際に非常に有効な手法です。

PageableとSortを使いこなすためのヒント

さらに高度な活用方法として、複数のソート条件をプログラム内で動的に生成することも可能です。例えば、特定の条件下では「作成日」の降順、それ以外では「タイトル」の昇順といった制御が必要な場合、以下のようにSortオブジェクトを個別に定義できます。

// 動的なソート条件の生成例
Sort sort = Sort.by("publishedDate").descending()
                .and(Sort.by("title").ascending());
Pageable customPageable = PageRequest.of(pageNumber, pageSize, sort);

これにより、URLパラメータに依存しない、システム内部での厳密な並び順制御が可能になります。Spring Bootの強力なエコシステムを理解し、これらの機能を適切に組み合わせることで、スケーラビリティに優れたバックエンドAPIを短期間で構築できるようになるでしょう。