パッケージ jakarta.faces.context

クラス ExternalContextFactory

java.lang.ObjectSE
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()
    使用すべきではありません。
    ラップされている実装を使用する他のコンストラクターを使用します。
    ExternalContextFactory(ExternalContextFactory wrapped)
    このファクトリが装飾されている場合、装飾を行う実装は、ラップされている実装をこのコンストラクターにプッシュする必要があります。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract ExternalContext
    getExternalContext(ObjectSE context, ObjectSE request, ObjectSE response)
    この Web アプリケーション用に、指定されたリクエストおよびレスポンスオブジェクトの処理のために初期化された ExternalContext インスタンスを（必要に応じて）作成して返します。
    ExternalContextFactory
    getWrapped()
    このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。

    クラス java.lang.ObjectSE から継承されたメソッド

    clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE

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

    • 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 の場合