1. PushBuilderクラスとは

JavaのServlet APIにおけるjavax.servlet.http.PushBuilderクラスは、HTTP/2の機能であるサーバープッシュを利用するためのクラスです。

サーバープッシュとは、クライアント（ブラウザ）からのリクエストを待たずに、必要となるリソース（画像、CSS、JavaScriptなど）をサーバーから先回りして送信する技術です。これにより、ページ表示速度を改善できます。

PushBuilderは、サーバーがそのようなリソースを積極的に送るための「設定インターフェース」のような役割を持っています。

このクラスは、Servlet3.1以降のバージョンで使用可能で、主にHttpServletRequestから取得して使用します。

2. PushBuilderのgetPathメソッドとは

PushBuilderクラスのgetPath()メソッドは、サーバーがプッシュしようとしているリソースのパスを取得するためのメソッドです。

例えば、/static/js/script.jsのようなリソースをプッシュ対象として設定している場合、このメソッドでそのパスを確認できます。

このメソッドは、String型の値を返します。設定されていない場合はnullを返します。

3. PushBuilder#getPathメソッドの使い方

それでは、実際にgetPath()メソッドの使い方を見てみましょう。


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

public class PushExampleServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        PushBuilder pushBuilder = request.newPushBuilder();

        if (pushBuilder != null) {
            pushBuilder.path("/static/js/app.js").push();
            String pushedPath = pushBuilder.getPath();
            System.out.println("プッシュ対象のパス: " + pushedPath);
        }

        response.getWriter().write("HTTP/2 Pushのテスト");
    }
}

上記の例では、Java ServletでPushBuilderを使い、JavaScriptファイル/static/js/app.jsをサーバープッシュしています。その後、getPath()メソッドを使って、設定したリソースのパスを取得しています。

4. getPathメソッドの使用例と注意点

このメソッドはあくまで「現在PushBuilderに設定されているパス」を取得するものであり、サーバー側で実際に送信されたパスとは限らないことに注意が必要です。

また、getPath()は読み取り専用であり、パスを変更したい場合はpath(String path)メソッドを使って設定しなおす必要があります。

以下のようにnullが返ることもあるため、nullチェックも忘れないようにしましょう。


String currentPath = pushBuilder.getPath();
if (currentPath != null) {
    System.out.println("現在のパス: " + currentPath);
} else {
    System.out.println("パスが設定されていません");
}