javax.servlet.jsp
クラス JspFactory

java.lang.Object
  |
  +--javax.servlet.jsp.JspFactory

public abstract class JspFactory
extends Object

JspFactoryはJSPを実装する様々なインタフェースやクラスのインスタンスを生成するために、 JSPページからランタイムに利用できるいくつかのファクトリーメソッドを定義した抽象クラスです。

JSPエンジンの実装は、その初期化の中でこのクラスのサブクラスによる実装をインスタンス化し、 静的な setDefaultFactory() メソッドを使い、 このクラスと共に生成されたインスタンスで登録されているJSP実装クラス全体で使用できるようにします。

PageContextとJspEngineInfoクラスはファクトリーで生成されたクラスを実装しただけです。

JspFactoryのオブジェクトはJSPページの制作者が使用すべきではありません。


コンストラクタの概要
JspFactory()
           
 
メソッドの概要
static JspFactory getDefaultFactory()
           
abstract  JspEngineInfo getEngineInfo()
           現在実装しているJSPエンジン特有の情報を取得するために呼び出します。
abstract  PageContext getPageContext(Servlet servlet, ServletRequest request, ServletResponse response, String errorPageURL, boolean needsSession, int buffer, boolean autoflush)
           Servlet及び不明なリクエストとレスポンスを呼び出すための抽象クラスである javax.servlet.jsp.PageContextの実装クラスのインスタンスを取得します。
abstract  void releasePageContext(PageContext pc)
           以前のPageContextオブジェクトへの割り当てを開放するときに呼び出します。
static void setDefaultFactory(JspFactory deflt)
           この実装のためのデフォルトのファクトリーを用意します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JspFactory

public JspFactory()
メソッドの詳細

setDefaultFactory

public static void setDefaultFactory(JspFactory deflt)

この実装のためのデフォルトのファクトリーを用意します。JSPエンジン ランタイムを除いてこのメソッドを呼び出す事は不正です。


getDefaultFactory

public static JspFactory getDefaultFactory()
戻り値:
この実装におけるデフォルトのファクトリー

getPageContext

public abstract PageContext getPageContext(Servlet servlet,
                                           ServletRequest request,
                                           ServletResponse response,
                                           String errorPageURL,
                                           boolean needsSession,
                                           int buffer,
                                           boolean autoflush)

Servlet及び不明なリクエストとレスポンスを呼び出すための抽象クラスである javax.servlet.jsp.PageContextの実装クラスのインスタンスを取得します。

このメソッドは通常、リクエスト処理を行うPageContextオブジェクトを得るための JSP実装クラスに含まれる_jspService()メソッドの処理の初期の段階で呼び出されます。

このメソッドを呼び出すことは、PageContext.initialize()メソッドを呼び出すことと同じです。 PageContextの戻り値は適切に初期化されます。

このメソッドによって得られた全てのPageContextオブジェクトは、 releasePageContext()によって開放されます。

パラメータ:
servlet - リクエストするサーブレット
request - Servlet がペンディングしている現在のリクエスト
response - Servlet がペンディングしている現在のレスポンス
errorPageURL - JSPリクエストに対するエラーページのURL、もしくはnull
needsSession - JSPセッションを必要とする時に真
buffer - バッファのバイトサイズ。バッファがない場合 PageContext.NO_BUFFER、実装しない場合はPageContext.DEFAULT_BUFFER
autoflush - バッファオーバーフローの際にバッファをアウトプットストリームに自動的にフラッシュするか、もしくはIOException をスローするかを選択する。
戻り値:
ページコンテキスト
関連項目:
PageContext

releasePageContext

public abstract void releasePageContext(PageContext pc)

以前のPageContextオブジェクトへの割り当てを開放するときに呼び出します。 PageContext.release()を呼び出したときと同じ結果が得られます。 このメソッドはJSP実装クラスの_jspService()メソッドから戻る前に呼び出されます。

パラメータ:
pc - getPageContext()により取得したページコンテキスト

getEngineInfo

public abstract JspEngineInfo getEngineInfo()

現在実装しているJSPエンジン特有の情報を取得するために呼び出します。

戻り値:
現在のJSPエンジンに関するJspEngineInfoオブジェクト


このドキュメントは、Ja-Jakarta Project により翻訳されました。コメントがある場合は、jajakarta-report@jajakarta.good-day.netまでお願いします。

Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.