パッケージ jakarta.faces.context

クラス ExternalContextFactory

  • 実装されたすべてのインターフェース:
    FacesWrapper<ExternalContextFactory>
    public abstract class ExternalContextFactory
extends ObjectSE
implements FacesWrapper<ExternalContextFactory>

    ExternalContextFactory は、指定されたリクエストおよびレスポンスオブジェクトの処理用に初期化された（必要な場合）作成し、新しい ExternalContext インスタンスを返すファクトリオブジェクトです。

    Jakarta Server Faces を利用する Web アプリケーションごとに 1 つの ExternalContextFactory インスタンスが必要です。このインスタンスは、次の呼び出しにより、移植可能な方法で取得できます。

     ExternalContextFactory factory = (ExternalContextFactory) FactoryFinder.getFactory(FactoryFinder.EXTERNAL_CONTEXT_FACTORY);

    使用方法: このクラスを継承し、ラップされている実装をコンストラクターにプッシュし、getWrapped() を使用してラップされているインスタンスにアクセスします。

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

      • ExternalContextFactory

        @DeprecatedSE
public ExternalContextFactory()
        使用すべきではありません。
        ラップされている実装を使用する他のコンストラクターを使用します。

      • ExternalContextFactory

        public ExternalContextFactory​(ExternalContextFactory wrapped)

        このファクトリが装飾されている場合、装飾を行う実装は、ラップされている実装をこのコンストラクターにプッシュする必要があります。getWrapped() は、ラップされている実装を返します。

        パラメーター:
        wrapped - ラップされる実装。

    • メソッドの詳細

      • getWrapped

        public ExternalContextFactory getWrapped()

        このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。

        次で指定:
        インターフェース FacesWrapper<ExternalContextFactory> の getWrapped 
        戻り値:
        ラップされたインスタンス。
        導入:
        2.0

      • getExternalContext

        public abstract ExternalContext getExternalContext​(ObjectSE context,
                                                   ObjectSE request,
                                                   ObjectSE response)
                                            throws FacesException

        この Web アプリケーション用に、指定されたリクエストおよびレスポンスオブジェクトの処理のために初期化された ExternalContext インスタンスを（必要に応じて）作成して返します。

        パラメーター:
        context - Jakarta Servlet 環境では、この Web アプリケーションに関連付けられている ServletContext 
        request - Jakarta Servlet 環境では、処理される ServletRequest 
        response - Jakarta Servlet 環境では、処理される ServletResponse 
        戻り値:
        ExternalContext のインスタンス。
        例外:
        FacesException - 指定されたパラメーターに対して ExternalContext を作成できない場合
        NullPointerExceptionSE - パラメーターのいずれかが null の場合