クラス JspFactory
- java.lang.ObjectSE
-
- jakarta.servlet.jsp.JspFactory
public abstract class JspFactory extends ObjectSE
JspFactory は、JSP 実装をサポートするために使用されるさまざまなインターフェースとクラスのインスタンスを作成する目的で、実行時に JSP ページで使用できる多数のファクトリメソッドを定義する抽象クラスです。
適合 JSP エンジン実装は、初期化中にこのクラスの実装依存サブクラスをインスタンス化し、静的
setDefaultFactory()
メソッドを介してこのクラスで作成されたインスタンスを登録することにより、JSP 実装クラスでグローバルに使用できるようにします。ファクトリから作成できる実装依存のクラスは、PageContext、JspEngineInfo、JspApplicationContext のみです。
JspApplicationContext を除き、JspFactory オブジェクトは JSP アプリケーション開発者が使用しないでください。
コンストラクターのサマリー
コンストラクター コンストラクター 説明 JspFactory()
唯一のコンストラクター。
メソッドのサマリー
すべてのメソッド 静的メソッド インスタンスメソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 static JspFactory
getDefaultFactory()
この実装のデフォルトファクトリを返します。abstract JspEngineInfo
getEngineInfo()
現在の JSP エンジンに関する実装固有の情報を取得するために呼び出されます。abstract JspApplicationContext
getJspApplicationContext(ServletContext context)
指定されたServletContext
の Web アプリケーションに関連付けられたJspApplicationContext
インスタンスを取得します。abstract PageContext
getPageContext(Servlet servlet, ServletRequest request, ServletResponse response, StringSE errorPageURL, boolean needsSession, int buffer, boolean autoflush)
呼び出し側サーブレットおよび現在保留中のリクエストとレスポンスの実装に依存する jakarta.servlet.jsp.PageContext 抽象クラスのインスタンスを取得します。abstract void
releasePageContext(PageContext pc)
以前に割り当てられた PageContext オブジェクトを解放するために呼び出されます。static void
setDefaultFactory(JspFactory deflt)
この実装のデフォルトファクトリを設定します。
メソッドの詳細
setDefaultFactory
public static void setDefaultFactory(JspFactory deflt)
この実装のデフォルトファクトリを設定します。JSP エンジンランタイム以外のプリンシパルがこのメソッドを呼び出すことは不正です。
- パラメーター:
deflt
- デフォルトのファクトリ実装
getDefaultFactory
public static JspFactory getDefaultFactory()
この実装のデフォルトファクトリを返します。- 戻り値:
- この実装のデフォルトファクトリ
getPageContext
public abstract PageContext getPageContext(Servlet servlet, ServletRequest request, ServletResponse response, StringSE errorPageURL, boolean needsSession, int buffer, boolean autoflush)
呼び出し側サーブレットおよび現在保留中のリクエストとレスポンスの実装に依存する jakarta.servlet.jsp.PageContext 抽象クラスのインスタンスを取得します。
通常、このメソッドは、処理中のリクエストの PageContext オブジェクトを取得するために、JSP 実装クラスの _jspService() メソッドの処理の早い段階で呼び出されます。
このメソッドを呼び出すと、PageContext.initialize() メソッドが呼び出されます。返された PageContext は適切に初期化されています。
このメソッドを介して取得されたすべての PageContext オブジェクトは、releasePageContext() を呼び出すことにより解放されます。
- パラメーター:
servlet
- リクエスト元のサーブレットrequest
- サーブレットで保留中の現在のリクエストresponse
- サーブレットで保留中の現在のレスポンスerrorPageURL
- リクエスト元の JSP のエラーページの URL、または nullneedsSession
- JSP がセッションに参加する場合は truebuffer
- バッファのサイズ(バイト単位)、バッファがない場合は JspWriter.NO_BUFFER、実装がデフォルトの場合は JspWriter.DEFAULT_BUFFERautoflush
- バッファオーバーフロー時にバッファを出力ストリームに自動フラッシュするか、IOException をスローする必要がありますか?- 戻り値:
- ページコンテキスト
- 関連事項:
PageContext
releasePageContext
public abstract void releasePageContext(PageContext pc)
以前に割り当てられた PageContext オブジェクトを解放するために呼び出されます。PageContext.release() が呼び出されます。このメソッドは、JSP 実装クラスの _jspService() メソッドから戻る前に呼び出す必要があります。
- パラメーター:
pc
- getPageContext() によって以前に取得された PageContext
getEngineInfo
public abstract JspEngineInfo getEngineInfo()
現在の JSP エンジンに関する実装固有の情報を取得するために呼び出されます。
- 戻り値:
- 現在の JSP エンジンを記述する JspEngineInfo オブジェクト
getJspApplicationContext
public abstract JspApplicationContext getJspApplicationContext(ServletContext context)
指定されたServletContext
の Web アプリケーションに関連付けられたJspApplicationContext
インスタンスを取得します。- パラメーター:
context
- 目的のJspApplicationContext
が関連付けられている Web アプリケーションのServletContext
。- 戻り値:
- Web アプリケーションに関連付けられた
JspApplicationContext
。 - 導入:
- 2.1