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

1. HttpServletRequestWrapperとは

「1. HttpServletRequestWrapperとは」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. HttpServletRequestWrapperとは

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

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

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

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

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

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

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

3. 基本的な実装例

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を継承し、特定の動作だけを上書きできます。

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

「4. Filterと組み合わせて使う」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

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);
    }
}

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

5. 複雑な処理にも応用可能

5. 複雑な処理にも応用可能

HttpServletRequestWrapperを使えば、次のような高度な処理も実現可能です。

• JSONボディの再読み取り
• ヘッダーの追加や書き換え
• セキュリティチェックによる入力制限
• ログ記録用のラッピング

Servlet APIの設計において非常に重要なカスタマイズ手段となります。

6. HttpServletRequestWrapperの利点と注意点

6. HttpServletRequestWrapperの利点と注意点

利点としては、既存のコードに大きな変更を加えずに、リクエストの挙動を柔軟に変更できる点があります。

ただし、リクエストボディの再読み取りには特別な対応が必要で、getReader()やgetInputStream()を扱う場合はバッファリングなどの工夫が必要になります。

また、Filterの登録順序にも注意が必要です。認証処理やロギングなど、他のフィルタとの影響を考慮しましょう。

まとめ

「まとめ」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

まとめ

HttpServletRequestWrapperの全体像と重要性

JavaのWebアプリケーション開発において、HttpServletRequestWrapperはリクエストの内容を柔軟に制御するための非常に重要な仕組みです。通常のHttpServletRequestは読み取り専用に近い形で扱われるため、そのままではパラメータやヘッダーを変更することはできません。しかし、HttpServletRequestWrapperを利用することで、既存のリクエストをラップし、必要な部分だけを上書きすることが可能になります。

このラップという考え方は、オブジェクト指向におけるデコレータパターンの一種であり、元の機能を壊さずに拡張できる点が大きな特徴です。Spring BootやServlet環境において、入力値の加工やセキュリティ対策、ログ記録など、さまざまな場面で活用されます。

実務でよく使われる用途と具体例

HttpServletRequestWrapperは、単なる学習用の技術ではなく、実務でも頻繁に利用される重要な機能です。特に以下のようなケースで活用されます。

• リクエストパラメータの強制書き換え
• 不正な入力値の除去やサニタイズ処理
• ヘッダー情報の追加や変更
• JSONリクエストの再利用やログ出力
• 共通処理の一元管理

例えば、ユーザー入力に危険な文字列が含まれている場合、Wrapperを使って事前に除去することで、セキュリティリスクを大幅に軽減することができます。

入力値を加工するサンプル実装

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

public class SanitizingRequestWrapper extends HttpServletRequestWrapper {

    public SanitizingRequestWrapper(HttpServletRequest request) {
        super(request);
    }

    @Override
    public String getParameter(String name) {
        String value = super.getParameter(name);
        if (value != null) {
            // 危険な文字列を簡易的に除去
            value = value.replaceAll("<", "")
                         .replaceAll(">", "");
        }
        return value;
    }
}

このようにgetParameterメソッドをオーバーライドすることで、リクエストパラメータを取得するたびに安全な値へ変換することができます。これにより、各コントローラで個別に対策を書く必要がなくなります。

Filterと組み合わせた実践的な設計

HttpServletRequestWrapperは単体では意味を持たず、Filterと組み合わせて使用することで本来の力を発揮します。Filterでリクエストを受け取り、Wrapperで包んだ上で次の処理へ渡すことで、アプリケーション全体に共通の処理を適用できます。

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

public class SanitizingFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {

        HttpServletRequest httpRequest = (HttpServletRequest) request;
        SanitizingRequestWrapper wrappedRequest = new SanitizingRequestWrapper(httpRequest);

        chain.doFilter(wrappedRequest, response);
    }
}

この構成により、すべてのリクエストに対して統一された処理を適用することができ、保守性と安全性が大きく向上します。

リクエストボディ処理と注意点

HttpServletRequestWrapperを使用する際に特に注意すべき点は、リクエストボディの扱いです。通常、InputStreamやReaderは一度しか読み取ることができません。そのため、ボディを再利用したい場合は、バッファに保存してから返すような実装が必要になります。

また、Filterの実行順序にも注意が必要です。認証処理やログ出力など他のフィルタとの関係を考慮しないと、意図しない動作になる可能性があります。設計段階で処理の流れを整理しておくことが重要です。

まとめとしての理解ポイント

• HttpServletRequestWrapperはリクエストを拡張する仕組み
• 既存の機能を壊さずにカスタマイズ可能
• Filterと組み合わせて使用するのが基本
• セキュリティ対策やログ処理に有効
• リクエストボディの扱いには注意が必要

このようにHttpServletRequestWrapperは、Java ServletやSpring Bootの内部動作を理解するうえでも重要な技術です。単なる表面的な使い方だけでなく、設計としてどう活用するかを意識することで、より安全で拡張性の高いアプリケーション開発が可能になります。