パッケージ org.springframework.web.jsf

クラス DecoratingNavigationHandler

java.lang.ObjectSE
jakarta.faces.application.NavigationHandler
org.springframework.web.jsf.DecoratingNavigationHandler
public abstract class DecoratingNavigationHandler extends NavigationHandlerEE
元の NavigationHandler を装飾できるようにする JSF NavigationHandler 実装の基本クラス。

標準の JSF スタイルの装飾（コンストラクター引数を使用）と、明示的な NavigationHandler 引数（元の NavigationHandler で渡す）を指定したオーバーロードされた handleNavigation メソッドをサポートします。サブクラスは、このオーバーロードされた handleNavigation メソッドを実装する必要があります。標準の JSF 呼び出しは、コンストラクターによって注入された NavigationHandler を引数として、オーバーロードされたメソッドに自動的に委譲します。

導入:
1.2.7
作成者:
Juergen Hoeller
関連事項:

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

    • DecoratingNavigationHandler

      protected DecoratingNavigationHandler()
      元の NavigationHandler を修正せずに DecoratingNavigationHandler を作成します。

    • DecoratingNavigationHandler

      protected DecoratingNavigationHandler(NavigationHandlerEE originalNavigationHandler)
      元の NavigationHandler を修正して DecoratingNavigationHandler を作成します。
      パラメーター:
      originalNavigationHandler - 飾る元の NavigationHandler

  • メソッドの詳細

    • getDecoratedNavigationHandler

      @Nullable public final NavigationHandlerEE getDecoratedNavigationHandler()
      このハンドラーによってデコレートされた固定の元の NavigationHandler を返します（コンストラクターを介して渡された場合）。

    • handleNavigation

      public final void handleNavigation(FacesContextEE facesContext, StringSE fromAction, StringSE outcome)
      標準の JSF handleNavigation メソッドのこの実装は、オーバーロードされたバリアントに委譲し、コンストラクターによって注入された NavigationHandler を引数として渡します。
      次で指定:
      クラス NavigationHandlerEE の handleNavigationEE 
      関連事項:

    • handleNavigation

      public abstract void handleNavigation(FacesContextEE facesContext, @Nullable StringSE fromAction, @Nullable StringSE outcome, @Nullable NavigationHandlerEE originalNavigationHandler)
      明示的な NavigationHandler 引数を持つ特別な handleNavigation バリアント。明示的な元のハンドラーを使用したコードによって直接呼び出されるか、標準の handleNavigation メソッドから呼び出されます（プレーンな JSF 定義の NavigationHandler として）。

      実装は callNextHandlerInChain を呼び出して、チェーンの次のハンドラーに委譲する必要があります。これは常に最も適切な次のハンドラーを呼び出します（callNextHandlerInChain javadoc を参照）。または、装飾された NavigationHandler または渡された元の NavigationHandler を直接呼び出すこともできます。ただし、これはチェーンの潜在的な位置に反応するという点ではそれほど柔軟ではありません。

      パラメーター:
      facesContext - 現在の JSF コンテキスト
      fromAction - 指定された結果を取得するために評価されたアクションバインディング式、または結果が他の手段で取得された場合は null 
      outcome - 以前に呼び出されたアプリケーションアクションによって返された論理結果 (null かもしれません)
      originalNavigationHandler - 元の NavigationHandler、またはない場合は null 
      関連事項:

    • callNextHandlerInChain

      protected final void callNextHandlerInChain(FacesContextEE facesContext, @Nullable StringSE fromAction, @Nullable StringSE outcome, @Nullable NavigationHandlerEE originalNavigationHandler)
      NavigationHandler チェーンの次のハンドラーに委譲するときにサブクラスによって呼び出されるメソッド。チェーン内のこのインスタンスの位置に応じて、コンストラクター引数として渡された装飾された NavigationHandler またはこのメソッドに渡された元の NavigationHandler のいずれかで、常に最も適切な次のハンドラーを呼び出します。

      コンストラクター引数として指定された、装飾された NavigationHandler を呼び出します（存在する場合）。ターゲットとして DecoratingNavigationHandler の場合、このメソッドに渡された元の NavigationHandler は、チェーンの次の要素に渡されます。これにより、ハンドラーチェーンの最後の要素がデリゲートして元のハンドラーを伝達できるようになります。ターゲットとして標準の NavigationHandler の場合、元のハンドラーは渡されません。そのシナリオでは、チェーンのさらに下で元の状態に戻すことはできません。

      装飾された NavigationHandler がコンストラクター引数として指定されていない場合、このインスタンスはチェーンの最後の要素です。このメソッドは、このメソッドに渡された元の NavigationHandler を呼び出します。元の NavigationHandler が渡されていない場合（たとえば、このインスタンスがチェーンの最後の要素であり、標準の NavigationHandlers が以前の要素である場合）、このメソッドは何もしないことに対応します。

      パラメーター:
      facesContext - 現在の JSF コンテキスト
      fromAction - 指定された結果を取得するために評価されたアクションバインディング式、または結果が他の手段で取得された場合は null 
      outcome - 以前に呼び出されたアプリケーションアクションによって返された論理結果 (null かもしれません)
      originalNavigationHandler - 元の NavigationHandler、またはない場合は null