JavaのHttpServletRequestWrapperのgetDateHeaderの使い方を完全解説！初心者でもわかるHTTPヘッダーの日付取得方法

1. getDateHeaderメソッドとは

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

1. getDateHeaderメソッドとは

getDateHeader()メソッドは、HTTPリクエストのヘッダーから指定された名前のヘッダー値を日時として取得するためのメソッドです。

このメソッドは、指定されたヘッダーの値をlong型のエポックミリ秒として返します。取得した値はjava.util.Dateに変換して使うことが一般的です。

もしヘッダーが存在しない場合は-1が返され、フォーマットが無効な場合はIllegalArgumentExceptionがスローされます。

2. getDateHeaderの使い方

2. getDateHeaderの使い方

以下のコードは、"If-Modified-Since"というリクエストヘッダーから日時情報を取得して表示する例です。

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

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

    public void printDateHeader() {
        long dateMillis = getDateHeader("If-Modified-Since");
        if (dateMillis != -1) {
            Date date = new Date(dateMillis);
            System.out.println("If-Modified-Since: " + date);
        } else {
            System.out.println("ヘッダーが存在しません。");
        }
    }
}

このように、取得したUNIX時間をDateに変換して扱います。

3. よく使われる日付系HTTPヘッダー

3. よく使われる日付系HTTPヘッダー

getDateHeader()を使って取得される代表的なHTTPヘッダーには以下のようなものがあります。

• If-Modified-Since：キャッシュが有効かどうかを判断するための日時
• If-Unmodified-Since：変更がない場合にのみ処理を行う
• Date：リクエストの作成日時（通常はレスポンス用）

特にキャッシュ制御や条件付きリクエストにおいて、日付情報は重要な役割を果たします。

4. getDateHeaderを使う上での注意点

「4. getDateHeaderを使う上での注意点」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. getDateHeaderを使う上での注意点

getDateHeader()で取得できる日時は、HTTPヘッダー内で定義された形式に従っていないと例外が発生します。RFC 1123形式である必要があるため、必ず信頼できるリクエストのみを処理するようにしましょう。

また、存在しない場合に-1が返されるため、必ず条件分岐でのチェックが必要です。

5. 実用例：条件付きGET処理

5. 実用例：条件付きGET処理

たとえば、If-Modified-Sinceヘッダーを使って、リソースが変更されていない場合には304 Not Modifiedを返すような処理が可能です。

long ifModifiedSince = request.getDateHeader("If-Modified-Since");
if (ifModifiedSince != -1 && resourceLastModified <= ifModifiedSince) {
    response.setStatus(HttpServletResponse.SC_NOT_MODIFIED);
    return;
}

これにより、無駄なデータ転送を避け、パフォーマンスの向上と帯域の節約に繋がります。