先生と生徒の会話形式で理解しよう

生徒

「Play Frameworkでクエリパラメータを受け取る方法ってどうすればいいんですか？ルーティングで扱えるんでしょうか？」

先生

「Play Frameworkではルーティング設定とコントローラを組み合わせることで、クエリパラメータをとても簡単に扱えますよ。ウェブアプリケーション開発で頻繁に使う重要な仕組みです。」

生徒

「ルーティングファイルでは何か特別な書き方が必要なんですか？URLの書き方にもルールがあるんでしょうか？」

先生

「ルーティングでは複雑な設定は必要ありません。クエリパラメータはURLの後ろに付けて送るだけで、Play Framework側が自動で受け取れるようになっています。では順番にわかりやすく学んでいきましょう。」

Play Frameworkでクエリパラメータが重要な理由

ウェブアプリケーションでは、検索機能や一覧画面の絞り込み、ページネーションなど、さまざまな場面でクエリパラメータが使われます。Play Frameworkは軽量で高速なウェブフレームワークとして知られており、クエリパラメータの扱いも非常に簡単で、初心者でも迷わずに実装できます。URLから値を読み取り、コントローラで処理し、画面に反映する流れを理解することで、動的な機能を自由に作れるようになります。

Play Frameworkのルーティングとクエリパラメータの基本

Play Frameworkでは、ルーティングファイルでURLパスと、どのコントローラのどのメソッドを呼び出すかを定義します。クエリパラメータは、ルーティングファイル側で特別な記述をしなくても扱うことができ、URLに付いている値をそのまま取得できます。例えば、?keyword=java のような形式です。

ルーティングファイルでは、クエリパラメータを変数として書く必要がなく、Play Framework側がリクエストオブジェクトから読み取れるため、初心者でも直感的に扱えます。これは、複数のクエリパラメータや、任意のパラメータを扱うときにも便利です。

routesファイルの基本書き方とクエリパラメータの扱い

まずはPlay Frameworkのconf/routesファイルに、通常のルートを定義します。クエリパラメータはURLに含まれるだけなので特別な書き方は不要です。


GET     /search            controllers.SearchController.search

上記のように定義すれば、例えば次のようなURLですぐにクエリパラメータを利用できます。


/search?keyword=playframework&page=2

このURLを開けば、keyword や page の値をコントローラで使うことができます。初心者でもルーティングの書き方を覚える負担が小さいので、学習をスムーズに進められます。

コントローラでクエリパラメータを受け取る方法

Play Frameworkでは、コントローラでHttp.Requestを使ってクエリパラメータを取得します。以下は、検索キーワードとページ番号を取得する例です。


package controllers;

import play.mvc.*;

public class SearchController extends Controller {

    public Result search(Http.Request request) {
        String keyword = request.getQueryString("keyword");
        String page = request.getQueryString("page");

        if (keyword == null) {
            keyword = "未指定";
        }
        if (page == null) {
            page = "1";
        }

        String message = "検索キーワード: " + keyword + " / ページ: " + page;
        return ok(message);
    }
}

このように、クエリパラメータを名前で指定して取り出すだけなのでとても簡単です。値が存在しない場合の処理も柔軟に書くことができるため、実践的な開発に応用しやすい構造になっています。

複数のクエリパラメータを扱う実践的な例

実際のウェブアプリケーションでは、複数のクエリパラメータを同時に扱うケースも多くあります。例えば、カテゴリ、ソート順、ページ番号などを含む複数条件の絞り込みです。Play Frameworkでは、それらを簡単に取り出すことができ、値が存在しない場合の処理もまとめて行えます。


public Result list(Http.Request request) {
    String category = request.getQueryString("category");
    String sort = request.getQueryString("sort");
    String page = request.getQueryString("page");

    if (category == null) category = "all";
    if (sort == null) sort = "desc";
    if (page == null) page = "1";

    String info = "カテゴリ:" + category + " / ソート:" + sort + " / ページ:" + page;
    return ok(info);
}

このように書くことによって、URLの構成に応じて条件を変更して表示したり、ユーザーの操作に合わせて柔軟に画面を更新したりすることができます。初心者でも理解しやすく、実践的な実装につながる大切なポイントです。

クエリパラメータとルーティングの関係を深く理解する

Play Frameworkのルーティングは、URLパスのパラメータとクエリパラメータを明確に区別しています。クエリパラメータはURLの後ろに「?name=value」の形式で付けるもので、ルーティングファイルの記述に影響を与えません。これにより、ルートそのものを増やさずに柔軟な検索機能やフィルタリング機能を実装できます。

ウェブアプリケーション開発では、この仕組みを理解することで、ユーザーにとって使いやすく、開発者にとっても管理しやすいAPI設計や画面遷移を実現できます。Play Frameworkはこの点で非常に扱いやすく、初心者から中級者へのステップアップにも向いています。