PageContextとは―暗黙オブジェクトやフィールド、メソッドの解説。

PageContextとはサーブレット環境でJSPテクノロジーを使用する場合に役立つコンテキスト情報を提供するクラスです。暗黙オブジェクトやフィールド、メソッドについて解説しています。

1. PageContextとは

PageContext（javax.servlet.jsp.PageContext）は、 javax.servlet.jsp.JspContextを継承して、サーブレット環境でJSPテクノロジーを使用する場合に役立つコンテキスト情報を提供するクラスです。

PageContextクラスのインスタンスは、JSPページに関連付けられたすべてのネームスペースへのアクセスを提供し、いくつかのページ属性へのアクセスを提供し、実装の詳細の上にあるレイヤーも提供します。

2. pageContextオブジェクト

PageContextクラスのインスタンスは、暗黙的なオブジェクトとして、pageContextという名前で自動的に追加されます。これをpageContextオブジェクトといいます。

暗黙的なオブジェクト

JSPでは、宣言せずに使用できるオブジェクトとしてrequest、response、pageContext、session、application、config、page、exceptionを用意しています。これらのオブジェクトのことを暗黙的なオブジェクトといいます。

3. フィールドの一覧

PageContextクラスのフィールドの一覧です。

PageContextクラスのフィールドの一覧
修飾子と型	フィールド	説明
static String	APPLICATION	ServletContext を PageContext 名前テーブルに保存するために使用される名前です。
static int	APPLICATION_SCOPE	アプリケーションスコープ: 名前付き参照は、再生されるまで ServletContext で利用可能です。
static String	CONFIG	ServletConfig を PageContext 名前テーブルに保存するために使用される名前です。
static String	EXCEPTION	ServletRequest 属性リストおよび PageContext 名前テーブルにキャッチされていない例外を格納するために使用される名前です。
static String	OUT	現在の JspWriter を PageContext 名前テーブルに保存するために使用される名前です。
static String	PAGE	この PageContext の名前テーブルにサーブレットを格納するために使用される名前です。
static int	PAGE_SCOPE	ページ範囲: （これがデフォルトです）名前付き参照は、現在の Servlet.service() 呼び出しから戻るまで、この PageContext で利用可能です。
static String	PAGECONTEXT	この PageContext を独自の名前テーブルに保存するために使用される名前です。
static String	REQUEST	ServletRequest を PageContext 名前テーブルに保存するために使用される名前。
static int	REQUEST_SCOPE	リクエストスコープ: 名前付き参照は、現在のリクエストが完了するまで、サーブレットに関連付けられた ServletRequest から利用可能のままです。
static String	RESPONSE	ServletResponse を PageContext 名前テーブルに保存するために使用される名前です。
static String	SESSION	HttpSession を PageContext 名前テーブルに保存するために使用される名前です。
static int	SESSION_SCOPE	セッションスコープ（このページがセッションに参加している場合のみ有効）: HttpSession が無効化されるまで、名前付き参照は、サーブレットに関連付けられた HttpSession（存在する場合）から引き続き利用可能です。

4. メソッドの一覧

PageContextクラスのメソッドの一覧です。

PageContextクラスのメソッドの一覧
修飾子と型	メソッド	説明
abstract void	forward(StringSE relativeUrlPath)	このメソッドは、現在の ServletRequest および ServletResponse をアプリケーション内の別のアクティブなコンポーネントにリダイレクトまたは「転送」するために使用されます。
ErrorData	getErrorData()	エラー情報への便利なアクセスを提供します。
abstract Exception	getException()	例外オブジェクトの現在の値（例外）です。
abstract Object	getPage()	ページオブジェクトの現在の値（サーブレット環境では、これは javax.servlet.Servlet のインスタンスです）。
abstract ServletRequest	getRequest()	リクエストオブジェクトの現在の値（ServletRequest）です。
abstract ServletResponse	getResponse()	レスポンスオブジェクトの現在の値（ServletResponse）です。
abstract ServletConfig	getServletConfig()	ServletConfig インスタンスです。
abstract ServletContext	getServletContext()	ServletContext インスタンスです。
abstract HttpSession	getSession()	セッションオブジェクトの現在の値（HttpSession）です。
abstract void	handlePageException(ExceptionSE e)	このメソッドは、この JSP の指定されたエラーページに例外を転送することにより、未処理の「ページ」レベルの例外を処理することを目的としています。
abstract void	handlePageException(ThrowableSE t)	このメソッドは、この JSP の指定されたエラーページに例外を転送することにより、未処理の「ページ」レベルの例外を処理することを目的としています。
abstract void	include(StringSE relativeUrlPath)	指定されたリソースが、呼び出しスレッドによって処理されている現在の ServletRequest および ServletResponse の一部として処理されるようにします。
abstract void	include(StringSE relativeUrlPath, boolean flush)	指定されたリソースが、呼び出しスレッドによって処理されている現在の ServletRequest および ServletResponse の一部として処理されるようにします。
abstract void	initialize(Servlet servlet, ServletRequest request, ServletResponse response, StringSE errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush)	初期化メソッドは、初期化されていない PageContext を初期化するために呼び出され、JSP 実装クラスが _jspService() メソッド内で受信リクエストとレスポンスを処理するために使用できるようにします。
BodyContent	pushBody()	新しい BodyContent オブジェクトを返し、現在の「出力」JspWriter を保存し、PageContext のページスコープ属性ネームスペースの "out" 属性の値を更新します。
abstract void	release()	このメソッドは、PageContext の内部状態を「リセット」し、すべての内部参照を解放し、initialize() の以降の呼び出しによる潜在的な再利用のために PageContext を準備します。