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

生徒

「PushBuilderで設定したヘッダの値って、あとから取り出すことはできますか？」

先生

「もちろんできます。getHeaderメソッドを使えば、指定したヘッダ名に対応する値を取得できますよ。」

生徒

「それなら、設定されているかどうかの確認にも使えそうですね！」

先生

「その通りです。では、getHeaderの使い方を詳しく見ていきましょう。」

1. getHeaderメソッドとは？

javax.servlet.http.PushBuilderインターフェースのgetHeader(String name)メソッドは、指定したヘッダ名に対応する値を取得するためのメソッドです。存在しないヘッダ名を指定するとnullが返されます。

2. getHeaderの基本的な使い方

以下のコードは、setHeaderで設定した後にgetHeaderで値を取得するシンプルな例です。


PushBuilder pushBuilder = request.newPushBuilder();

if (pushBuilder != null) {
    pushBuilder.setHeader("Content-Type", "text/css");
    String contentType = pushBuilder.getHeader("Content-Type");
    System.out.println("Content-Type: " + contentType);
}

3. nullが返るケースに注意

指定したヘッダ名がまだ設定されていない場合、getHeaderはnullを返します。nullチェックを忘れるとNullPointerExceptionの原因になるため、必ずnullかどうかを確認しましょう。


String value = pushBuilder.getHeader("X-Unknown-Header");
if (value == null) {
    System.out.println("指定されたヘッダは存在しません。");
}

4. 他のPushBuilderメソッドと併用

getHeaderはsetHeaderやaddHeaderなどでヘッダを設定したあとに、その確認用やロギング用途として活躍します。


pushBuilder.setHeader("X-Debug", "true");
String debugValue = pushBuilder.getHeader("X-Debug");
System.out.println("X-Debugヘッダの値: " + debugValue);

5. HTMLでの利用シーンの理解

PushBuilderは主にHTTP/2のサーバープッシュで使われ、HTMLでリンクされるCSSやJavaScriptファイルを事前に送信する際に使われます。このときヘッダ情報も重要な役割を果たします。


<link rel="stylesheet" href="/css/style.css">
<script src="/js/app.js"></script>

6. 複数のヘッダを扱うときの工夫

たとえば複数のヘッダを設定したあとに、それぞれの値をgetHeaderで取り出してログ出力すれば、実際のリクエスト内容が明確になり、トラブルシューティングにも役立ちます。


pushBuilder.setHeader("Cache-Control", "no-cache");
pushBuilder.setHeader("X-App-Version", "1.0.0");

System.out.println("Cache-Control: " + pushBuilder.getHeader("Cache-Control"));
System.out.println("X-App-Version: " + pushBuilder.getHeader("X-App-Version"));