JavaのHttpServletRequestWrapperとgetQueryStringメソッドを完全解説！初心者でも理解できるURLパラメータの取得方法

1. javax.servlet.httpパッケージとは

「1. javax.servlet.httpパッケージとは」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. javax.servlet.httpパッケージとは

JavaでWebアプリケーションを作るときによく使うパッケージがjavax.servlet.httpです。このパッケージには、HTTP通信に関する処理を行うためのクラスやインターフェースがたくさん用意されています。

その中のHttpServletRequestは、ブラウザから送られてきたリクエストの情報を取得するために使われる非常に重要なインターフェースです。

今回取り上げるHttpServletRequestWrapperは、そのリクエストをラップして、処理を追加したいときや一部の動作を上書きしたいときに便利なクラスです。

2. HttpServletRequestWrapperとは

2. HttpServletRequestWrapperとは

HttpServletRequestWrapperクラスは、HttpServletRequestの機能をそのまま受け継ぎつつ、カスタマイズや拡張ができるように作られたラッパークラスです。

たとえば、リクエストパラメータのバリデーションを追加したり、特定の値を上書きしたりすることができます。Webアプリケーションの開発で中〜上級者が使うことの多いクラスですが、初心者でも扱えるメソッドがたくさんあります。

3. getQueryStringメソッドの役割

3. getQueryStringメソッドの役割

getQueryStringメソッドは、ブラウザから送られてきたURLの中に含まれる「クエリ文字列」を取得するためのメソッドです。

クエリ文字列とは、URLの末尾に「?」以降に続くキー＝値の組み合わせのことです。たとえば、次のようなURLがあるとします：

http://localhost:8080/myapp/search?keyword=java&sort=asc

このとき、getQueryStringメソッドは以下の文字列を返します：

keyword=java&sort=asc

4. getQueryStringが役立つ場面

「4. getQueryStringが役立つ場面」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. getQueryStringが役立つ場面

getQueryStringメソッドは、主に次のようなケースで役立ちます：

• 検索フォームの入力内容をURLから取得したいとき
• ページ遷移時に渡されたパラメータをまるごとログ出力したいとき
• クエリ文字列を加工してリダイレクトURLに付け直したいとき
• URLの状態を再現してブックマーク機能を作りたいとき

このように、Webアプリケーションの機能を作るうえでクエリ文字列を扱う場面はとても多くあります。

5. HttpServletRequestWrapperでgetQueryStringを使うサンプルコード

5. HttpServletRequestWrapperでgetQueryStringを使うサンプルコード

それでは実際に、HttpServletRequestWrapperを使ってgetQueryStringメソッドの使い方を見てみましょう。

@WebServlet("/query-check")
public class QueryStringServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        HttpServletRequestWrapper wrapper = new HttpServletRequestWrapper(request);
        String query = wrapper.getQueryString();

        response.setContentType("text/plain; charset=UTF-8");
        if (query != null) {
            response.getWriter().println("クエリ文字列: " + query);
        } else {
            response.getWriter().println("クエリ文字列は指定されていません。");
        }
    }
}

6. getQueryStringの実行結果例

6. getQueryStringの実行結果例

URLに次のようにアクセスしたとします：

http://localhost:8080/myapp/query-check?category=books&price=2000

このときの出力結果は以下のようになります。

クエリ文字列: category=books&price=2000

もしURLにクエリパラメータが含まれていない場合には、次のように表示されます。

クエリ文字列は指定されていません。

7. 初心者が気をつけるべきポイント

「7. 初心者が気をつけるべきポイント」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. 初心者が気をつけるべきポイント

getQueryStringメソッドは、あくまでURLの末尾に付与されたパラメータを「文字列」として取得する機能です。値の取り出しやデコードなどは別の処理が必要になります。

たとえば、個別のパラメータを取得したい場合には、getParameterメソッドを使う方が便利です。しかし、URL全体を処理したいときにはgetQueryStringが適しています。

また、URLエンコードされている文字列（日本語など）が含まれている場合、必要に応じてURLDecoderクラスを使ってデコードする処理を追加することも検討しましょう。

8. 開発現場での活用例

8. 開発現場での活用例

たとえば検索機能を作るとき、ユーザーが入力した条件をクエリ文字列としてURLに付けることで、ページの再読込やリンク共有がしやすくなります。

そのクエリ文字列をgetQueryStringで取得し、ログに保存してユーザーの操作履歴を分析することも可能です。

また、クエリパラメータをもとにデータベース検索を行う際にも、getQueryStringで元の入力を記録しておけば、後から再検索しやすくなります。