パッケージ jakarta.servlet.jsp

クラス JspFactory


  • public abstract class JspFactory
    extends ObjectSE

    JspFactory は、JSP 実装をサポートするために使用されるさまざまなインターフェースとクラスのインスタンスを作成する目的で、実行時に JSP ページで使用できる多数のファクトリメソッドを定義する抽象クラスです。

    適合 JSP エンジン実装は、初期化中にこのクラスの実装依存サブクラスをインスタンス化し、静的  setDefaultFactory()  メソッドを介してこのクラスで作成されたインスタンスを登録することにより、JSP 実装クラスでグローバルに使用できるようにします。

    ファクトリから作成できる実装依存のクラスは、PageContext、JspEngineInfo、JspApplicationContext のみです。

    JspApplicationContext を除き、JspFactory オブジェクトは JSP アプリケーション開発者が使用しないでください。

    • コンストラクターの詳細

      • JspFactory

        public JspFactory()
        唯一のコンストラクター。(サブクラスコンストラクターによる呼び出しの場合、通常は暗黙的です。)
    • メソッドの詳細

      • 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、または null
        needsSession - JSP がセッションに参加する場合は true
        buffer - バッファのサイズ(バイト単位)、バッファがない場合は JspWriter.NO_BUFFER、実装がデフォルトの場合は JspWriter.DEFAULT_BUFFER
        autoflush - バッファオーバーフロー時にバッファを出力ストリームに自動フラッシュするか、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