JavaのHttpServletRequestWrapperを完全解説！初心者でもわかるリクエストラッパーの使い方

HttpServletRequestWrapper

教材紹介 Java学習のおすすめ教材

Javaの基礎を体系的に整理しながら学習したい方には、資格対策としても定評のある定番教材が参考になります。

Javaプログラマ Silver SE 17 教科書をAmazonで見る

※ Amazon広告リンク

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

生徒

「Servletでリクエストの内容を変更したいときって、どうすればいいんですか？」

先生

「その場合は、HttpServletRequestWrapperというクラスを使うと便利です。リクエストをラップして、メソッドの動作をカスタマイズできますよ。」

生徒

「ラップするってどういうことですか？」

先生

「それではHttpServletRequestWrapperの仕組みや使い方について詳しく説明していきましょう。」

1. HttpServletRequestWrapperとは

HttpServletRequestWrapperは、javax.servlet.httpパッケージに含まれるクラスで、HTTPリクエストをラップ（包み込む）して、元のリクエストの動作を変更・拡張するための仕組みです。

もともとのHttpServletRequestのインスタンスを受け取り、それに機能を追加したり、一部のメソッドの動作を上書きしたりできます。

2. どういうときに使うのか

HttpServletRequestWrapperは、以下のような場面で活躍します。

リクエストパラメータを動的に変更したいとき
リクエストヘッダーを追加・変更したいとき
セキュリティ対策で入力値をフィルタリングしたいとき
リクエストボディを再利用したいとき（通常は1回しか読み取れない）

こうした処理を行うには、Filterと組み合わせて使用するのが一般的です。

3. 基本的な実装例

ここでは、getParameter()メソッドをオーバーライドして、特定のリクエストパラメータを変更する例を紹介します。


import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;

public class CustomRequestWrapper extends HttpServletRequestWrapper {
    public CustomRequestWrapper(HttpServletRequest request) {
        super(request);
    }

    @Override
    public String getParameter(String name) {
        if ("username".equals(name)) {
            return "guest";
        }
        return super.getParameter(name);
    }
}

このようにHttpServletRequestWrapperを継承し、特定の動作だけを上書きできます。

サーブレットやJSPの基礎を体系的に理解したい人には、定番の入門書がこちらです。

スッキリわかるサーブレット＆JSP入門をAmazonで見る

※ Amazon広告リンク

4. Filterと組み合わせて使う

HttpServletRequestWrapperは単体で使うのではなく、Filterと組み合わせることで、リクエストがサーブレットに届く前に変更を加えることができます。


import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

public class CustomFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        CustomRequestWrapper wrappedRequest = new CustomRequestWrapper(req);
        chain.doFilter(wrappedRequest, response);
    }
}

これで、すべてのリクエストに対して自動的にラップされたリクエストが適用されます。