クラス FacesContextFactory
- java.lang.ObjectSE
-
- jakarta.faces.context.FacesContextFactory
- 実装されたすべてのインターフェース:
FacesWrapper<FacesContextFactory>
public abstract class FacesContextFactory extends ObjectSE implements FacesWrapper<FacesContextFactory>
FacesContextFactory は、（必要に応じて）新しい
FacesContextインスタンスを作成して返すファクトリオブジェクトであり、指定されたリクエストおよびレスポンスオブジェクトの処理用に初期化されます。実装では、割り当てられたFacesContextインスタンスのrelease()メソッドへの呼び出しを利用して、毎回新しいインスタンスを作成するのではなく、プールしてリサイクルすることができます。Jakarta Server Faces を利用する Web アプリケーションごとに 1 つの
FacesContextFactoryインスタンスが必要です。このインスタンスは、次の呼び出しにより、移植可能な方法で取得できます。FacesContextFactory factory = (FacesContextFactory) FactoryFinder.getFactory(FactoryFinder.FACES_CONTEXT_FACTORY);
使用方法: このクラスを継承し、ラップされている実装をコンストラクターにプッシュし、
getWrapped()を使用してラップされているインスタンスにアクセスします。
コンストラクターのサマリー
コンストラクター コンストラクター 説明 FacesContextFactory()使用すべきではありません。ラップされている実装を使用する他のコンストラクターを使用します。FacesContextFactory(FacesContextFactory wrapped)このファクトリが装飾されている場合、装飾を行う実装は、ラップされている実装をこのコンストラクターにプッシュする必要があります。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 abstract FacesContextgetFacesContext(ObjectSE context, ObjectSE request, ObjectSE response, Lifecycle lifecycle)この Web アプリケーション用に、指定されたLifecycleインスタンスを使用して、指定されたリクエストおよびレスポンスオブジェクトの処理用に初期化されたFacesContextインスタンスを作成し（必要な場合）返します。FacesContextFactorygetWrapped()このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。
コンストラクターの詳細
FacesContextFactory
@DeprecatedSE public FacesContextFactory()
使用すべきではありません。ラップされている実装を使用する他のコンストラクターを使用します。
FacesContextFactory
public FacesContextFactory(FacesContextFactory wrapped)
このファクトリが装飾されている場合、装飾を行う実装は、ラップされている実装をこのコンストラクターにプッシュする必要があります。
getWrapped()は、ラップされている実装を返します。- パラメーター:
wrapped- ラップされる実装。
メソッドの詳細
getWrapped
public FacesContextFactory getWrapped()
このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。
- 次で指定:
- インターフェース
FacesWrapper<FacesContextFactory>のgetWrapped - 戻り値:
- ラップされたインスタンス。
- 導入:
- 2.0
getFacesContext
public abstract FacesContext getFacesContext(ObjectSE context, ObjectSE request, ObjectSE response, Lifecycle lifecycle) throws FacesException
この Web アプリケーション用に、指定された
Lifecycleインスタンスを使用して、指定されたリクエストおよびレスポンスオブジェクトの処理用に初期化されたFacesContextインスタンスを作成し（必要な場合）返します。このメソッドの実装では、
FacesContextのgetCurrentInstance()メソッドを呼び出すと、このメソッドを呼び出したのと同じスレッドから、そのインスタンスでrelease()メソッドが呼び出されるまで、同じFacesContextインスタンスが返されるようにする必要があります。実装は
ExternalContextFactory.getExternalContext(java.lang.Object, java.lang.Object, java.lang.Object)を呼び出して、FacesContextインスタンスのExternalContextを生成する必要があります。デフォルトの実装では、
ExceptionHandlerFactory.getExceptionHandler()を呼び出して、そのメソッドからの戻りが、返されたFacesContextインスタンスでのFacesContext.getExceptionHandler()の呼び出しから返されるものになるようにする必要があります。デフォルトの実装では、
ClientWindowFactory.getClientWindow(jakarta.faces.context.FacesContext)を呼び出して、そのメソッドからの戻りが、返されたExternalContextインスタンスでのExternalContext.getClientWindow()の呼び出しから返されるものになるようにする必要があります。- パラメーター:
context- Jakarta Servlet 環境では、この Web アプリケーションに関連付けられているServletContextrequest- Jakarta Servlet 環境では、処理されるServletRequestresponse- Jakarta Servlet 環境では、処理されるServletResponselifecycle- このリクエストの処理に使用されているLifecycleインスタンス- 戻り値:
FacesContextのインスタンス。- 例外:
FacesException- 指定されたパラメーターに対してFacesContextを作成できない場合NullPointerExceptionSE- パラメーターのいずれかがnullの場合