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

生徒

「Javaのサーブレットで、リクエストされたパスのうち、サーブレットに対応している部分だけを取り出す方法ってありますか？」

先生

「はい、そのときはHttpServletRequestWrapperクラスのgetServletPathメソッドを使います。」

生徒

「それってURIとは違うんですか？」

先生

「はい、getRequestURIはリクエスト全体のパスですが、getServletPathはマッピングされたサーブレットの部分だけを返します。詳しく見ていきましょう！」

1. javax.servlet.httpパッケージとは

javax.servlet.httpパッケージは、JavaでWebアプリケーションを作成する際に必須となるクラスがまとめられたパッケージです。HttpServletRequestやHttpServletResponseなどの基本クラスがあり、HTTP通信のやり取りを簡単に操作できます。

2. HttpServletRequestWrapperとは

HttpServletRequestWrapperは、HttpServletRequestをラップするクラスで、元のリクエストをそのまま使いつつ、一部だけオーバーライドしたいときなどに便利です。ログの追加やセキュリティ処理のカスタマイズなどで活用されます。

3. getServletPathメソッドの概要

getServletPathメソッドは、現在のリクエストの中で「サーブレットにマッピングされている部分のパス」だけを返すメソッドです。

例えば、以下のようなURLでアクセスした場合：

http://localhost:8080/sample-app/products/view

このリクエストが/products/*にマッピングされている場合、getServletPath()の戻り値は：


/products

となります。

4. getServletPathの使いどころ

このメソッドは以下のような場面で役立ちます：

どのサーブレットにマッピングされたかをログに記録したいとき
処理の分岐をサーブレット単位で制御したいとき
ルーティング処理やコントローラの切り替えに使いたいとき

5. HttpServletRequestWrapperでgetServletPathを使うサンプル

以下は、HttpServletRequestWrapperを使ってgetServletPathを取得するサーブレットのコードです。


@WebServlet("/products/*")
public class ServletPathExample extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        HttpServletRequestWrapper wrapper = new HttpServletRequestWrapper(request);
        String servletPath = wrapper.getServletPath();

        response.setContentType("text/plain; charset=UTF-8");
        response.getWriter().println("サーブレットパス: " + servletPath);
    }
}