JavaのHttpServletRequestWrapperのgetHeadersの使い方を完全ガイド！複数のHTTPヘッダー値を取得する方法

1. getHeadersメソッドとは

1. getHeadersメソッドとは

getHeaders()メソッドは、指定したヘッダー名に一致するすべてのヘッダー値を列挙型（Enumeration<String>）として返すメソッドです。

これはjavax.servlet.http.HttpServletRequestインターフェースに定義されており、HttpServletRequestWrapperでもオーバーライドや利用が可能です。

2. getHeadersの基本的な使い方

2. getHeadersの基本的な使い方

以下のコードは、HTTPリクエストから"Accept-Language"ヘッダーのすべての値を取得して表示する例です。

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;
import java.util.Enumeration;

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

    public void printAcceptLanguages() {
        Enumeration<String> headers = getHeaders("Accept-Language");
        while (headers.hasMoreElements()) {
            String value = headers.nextElement();
            System.out.println("言語設定: " + value);
        }
    }
}

whileループで1つずつ列挙しながら取り出して処理できます。

3. getHeaderとの違い

3. getHeaderとの違い

getHeader()メソッドは、複数あるうちの「最初の1つ」だけを返します。一方、getHeaders()は該当する「すべての値」を返してくれます。

たとえば、クライアントがAccept-Language: jaとAccept-Language: enの2つを送ってきた場合、getHeader()ではjaしか取得できませんが、getHeaders()ならjaとenの両方が取得できます。

4. 応用例：全ヘッダーをまとめて出力

4. 応用例：全ヘッダーをまとめて出力

実用的な場面では、すべてのHTTPヘッダーをまとめてログに出力したいケースがあります。以下のコードでは、すべてのヘッダー名とその値を出力しています。

Enumeration<String> headerNames = request.getHeaderNames();
while (headerNames.hasMoreElements()) {
    String name = headerNames.nextElement();
    Enumeration<String> values = request.getHeaders(name);
    while (values.hasMoreElements()) {
        System.out.println(name + ": " + values.nextElement());
    }
}

デバッグ時やセキュリティログの取得時にとても役立ちます。

5. カスタムヘッダーとgetHeadersの相性

5. カスタムヘッダーとgetHeadersの相性

API開発などでは、X-Api-Keyのようなカスタムヘッダーがよく使われます。複数のキーや値を扱う場合にもgetHeaders()は非常に便利です。

セキュリティチェック、リクエスト分類、APIトークンの検出など、柔軟な処理が可能になります。

6. HttpServletRequestWrapperでgetHeadersをオーバーライドする方法

6. HttpServletRequestWrapperでgetHeadersをオーバーライドする方法

HttpServletRequestWrapperは、既存のHttpServletRequestをラップして独自の処理を追加できる便利なクラスです。getHeaders()をオーバーライドすることで、特定のヘッダー値を書き換えたり、追加したりすることも可能です。

たとえば、セキュリティ対策として特定のヘッダー値をログに記録したり、アプリケーション内部で統一した値に変換したりするケースがあります。

@Override
public Enumeration<String> getHeaders(String name) {
    Enumeration<String> original = super.getHeaders(name);
    // 必要に応じて値を加工する処理を追加可能
    return original;
}

このように、ラッパークラスを使うことで柔軟なヘッダー制御が実現できます。

7. フィルターと組み合わせた活用例

7. フィルターと組み合わせた活用例

Servlet FilterとHttpServletRequestWrapperを組み合わせることで、アプリケーション全体に対してヘッダー処理を適用できます。

フィルター内でリクエストをラップし、getHeaders()を利用して特定のHTTPヘッダー値を検査することで、不正なアクセスの検出やログの強化が可能になります。

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) {
    HttpServletRequest httpRequest = (HttpServletRequest) request;
    HeaderWrapper wrapper = new HeaderWrapper(httpRequest);
    chain.doFilter(wrapper, response);
}

この方法は、セキュリティ対策やAPIゲートウェイ的な役割を実装する際に特に有効です。

8. getHeaders使用時の注意点

8. getHeaders使用時の注意点

getHeaders()は便利なメソッドですが、いくつか注意点もあります。まず、戻り値はEnumeration<String>であり、Listではないため、拡張for文はそのままでは使用できません。

また、存在しないヘッダー名を指定した場合は空のEnumerationが返されるため、nullチェックではなくhasMoreElements()での確認が重要です。

さらに、HTTPヘッダー名は大文字・小文字を区別しない仕様ですが、サーバー実装によって扱いが異なる場合があるため、正確なヘッダー名を指定するようにしましょう。

これらのポイントを押さえることで、HttpServletRequestWrapperのgetHeaders()をより安全かつ効果的に活用できます。

まとめ

まとめ

今回はJavaにおけるHttpServletRequestWrapperのgetHeadersメソッドについて、基本的な使い方から応用的な活用方法まで詳しく解説しました。Servlet環境でHTTPヘッダーを扱う場面は非常に多く、Webアプリケーション開発やAPI開発、セキュリティ対策、ログ出力処理など、さまざまなシーンで重要な役割を果たします。

特にgetHeadersは、同一名のHTTPヘッダーが複数存在する場合にすべての値を取得できるという点が大きな特徴です。getHeaderでは最初の一件しか取得できませんが、getHeadersを利用することでAccept LanguageやCookie、カスタムヘッダーなどの複数値を正しく処理できます。これはHTTP仕様に基づいた正確なリクエスト解析を行うために欠かせない知識です。

HttpServletRequestWrapperを利用すれば、既存のHttpServletRequestを拡張しながらヘッダー処理をカスタマイズできます。フィルター処理や認証処理の前段階でヘッダーを書き換えたり、ログ監視やセキュリティチェックを実装したりすることも可能です。大規模なWebシステムでは、リクエストの追跡やアクセス解析のためにヘッダー情報を正確に扱うことが求められます。

また、Enumerationを使ったループ処理はServlet開発では基本的なテクニックです。while文とhasMoreElementsを組み合わせることで、すべてのヘッダー値を安全に取り出せます。ヘッダー名一覧を取得するgetHeaderNamesと組み合わせれば、HTTPリクエストの全体像を把握できます。デバッグ作業やログ出力機能の実装時にも非常に役立ちます。

さらに、API連携やマイクロサービス構成では、認証トークンやカスタムヘッダーの処理が重要になります。X Api KeyやAuthorizationヘッダーなどを複数回送信するケースにも対応できるのがgetHeadersの強みです。Webセキュリティ対策としても、想定外の複数ヘッダーを検知することで不正アクセスの兆候を把握できます。

以下は、getHeadersとgetHeaderの違いを確認するサンプルプログラムです。

import javax.servlet.http.HttpServletRequest;
import java.util.Enumeration;

public class HeaderCheckExample {

    public static void printHeader(HttpServletRequest request) {

        String first = request.getHeader("Accept-Language");
        System.out.println("getHeaderの結果: " + first);

        Enumeration<String> all = request.getHeaders("Accept-Language");
        while (all.hasMoreElements()) {
            System.out.println("getHeadersの結果: " + all.nextElement());
        }
    }
}

実行時には、複数のAccept Languageが存在する場合にすべての値が順番に出力されます。

getHeaderの結果: ja
getHeadersの結果: ja
getHeadersの結果: en

このように、Java Servlet環境でHTTPヘッダーを正確に扱うためには、getHeadersメソッドの理解が欠かせません。Webアプリケーション開発においては、リクエスト解析、セキュリティ管理、API設計、ログ監視といった多方面で活用できる重要な知識です。