JavaのHttpServletRequestWrapperとgetServletPathメソッドを完全ガイド！初心者でもわかるサーブレットパスの取得方法

HttpServletRequestWrapperのgetServletPathメソッド

教材紹介 Java学習のおすすめ教材

Javaの基礎を体系的に整理しながら学習したい方には、資格対策としても定評のある定番教材が参考になります。

Javaプログラマ Silver SE 17 教科書をAmazonで見る

※ Amazon広告リンク

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

生徒

「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

となります。

サーブレットやJSPの基礎を体系的に理解したい人には、定番の入門書がこちらです。

スッキリわかるサーブレット＆JSP入門をAmazonで見る

※ Amazon広告リンク

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);
    }
}