JSPのpageContextオブジェクトとは？役割と主なメソッドをわかりやすく解説

pageContextオブジェクトとは

pageContextオブジェクトは、javax.servlet.jsp.PageContextクラスのインスタンスであり、JSPページ全体を表現するために使用される組み込みオブジェクトです。

このオブジェクトは、JSPページの実装の細部を意識することなく、ページに関する情報へアクセスできるようにするための仕組みとして設計されています。開発者はpageContextを通じて、ページの状態や各種オブジェクトへの参照を統一的に扱うことができます。

pageContextが保持する情報

pageContextオブジェクトは、リクエストごとにrequestオブジェクトとresponseオブジェクトへの参照を保持します。また、application、config、session、outといった他の組み込みオブジェクトも、このオブジェクトの属性にアクセスすることで取得できます。

さらに、pageContextにはJSPページに対して発行されたディレクティブに関する情報も含まれています。具体的には、バッファリングの設定情報、エラー発生時の遷移先を示すerrorPageURL、そしてページスコープなどの情報です。

スコープを識別するフィールドと提供されるメソッド

PageContextクラスでは、4つのスコープを識別するためのフィールドとしてPAGE_SCOPE、REQUEST_SCOPE、SESSION_SCOPE、APPLICATION_SCOPEが定義されています。

また、PageContextクラスは40以上のメソッドをサポートしており、そのうち約半数は親クラスであるjavax.servlet.jsp.JspContextクラスから継承されたものです。

重要なメソッド：removeAttribute

pageContextの重要なメソッドの一つがremoveAttributeです。このメソッドは、1つまたは2つの引数を受け取ることができます。

例えば、次のように引数を1つだけ指定して呼び出した場合、すべてのスコープから該当する属性が削除されます。

pageContext.removeAttribute("attrName");

一方、スコープを第2引数として明示的に指定すると、特定のスコープからのみ属性を削除できます。以下のコードは、ページスコープからのみ属性を削除する例です。

pageContext.removeAttribute("attrName", PAGE_SCOPE);

このように、pageContextオブジェクトを使いこなすことで、JSPページ内の属性管理やスコープ操作を柔軟かつ効率的に行うことができます。