DelegatingNavigationHandlerProxy (Spring Framework API)

java.lang.ObjectSE
- javax.faces.application.NavigationHandlerEE
- - org.springframework.web.jsf.DelegatingNavigationHandlerProxy

```
public class DelegatingNavigationHandlerProxy
extends NavigationHandlerEE
```
Spring ルート WebApplicationContext から取得した NavigationHandler Bean に委譲する JSF NavigationHandler 実装。
faces-config.xml ファイルでこのハンドラープロキシを次のように構成します。
```
 <application>
   ...
   <navigation-handler>
           org.springframework.web.jsf.DelegatingNavigationHandlerProxy
   </navigation-handler>
   ...
 </application>
```
デフォルトでは、Spring ApplicationContext は、Bean 名 "jsfNavigationHandler" で NavigationHandler を検索します。最も単純なケースでは、これは次のような単純な Spring Bean 定義です。ただし、Spring のすべての Bean 構成パワーは、このような Bean、特にすべての種類の依存性注入に適用できます。
```
 <bean name="jsfNavigationHandler" class="mypackage.MyNavigationHandler">
   <property name="myProperty" ref="myOtherBean"/>
 </bean>
```
ターゲット NavigationHandler Bean は通常、標準の JSF NavigationHandler クラスを継承します。ただし、このようなシナリオでは、元の NavigationHandler（JSF プロバイダーのデフォルトハンドラー）の装飾はサポートされていないことに注意してください。これは、元のハンドラーを標準の JSF スタイルで（つまり、コンストラクター引数として）挿入できないためです。
元の NavigationHandler を装飾するには、ターゲット Bean が Spring の DecoratingNavigationHandler クラスを継承していることを確認してください。これにより、このプロキシが自動的に検出するメソッド引数として元のハンドラーを渡すことができます。DecoratingNavigationHandler サブクラスは引き続き標準の JSF NavigationHandler としても機能することに注意してください。
このプロキシは、ナビゲーションハンドラーの検索に使用される Bean 名の変更、ターゲットハンドラーの取得に使用される戦略の変更、または ApplicationContext へのアクセスに使用される戦略の変更（通常は FacesContextUtils.getWebApplicationContext(FacesContext) を介して取得）にサブクラス化できます。
導入:
1.2.7
作成者:
Juergen Hoeller, Colin Sampaleanu
関連事項:
DecoratingNavigationHandler

フィールドサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`DEFAULT_TARGET_BEAN_NAME` Spring アプリケーションコンテキストでのターゲット Bean のデフォルト名: "jsfNavigationHandler"。

コンストラクターのサマリー

コンストラクター
コンストラクターと説明
`DelegatingNavigationHandlerProxy()` 新しい DelegatingNavigationHandlerProxy を作成します。
`DelegatingNavigationHandlerProxy(NavigationHandlerEE originalNavigationHandler)` 新しい DelegatingNavigationHandlerProxy を作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected BeanFactory`	`getBeanFactory(FacesContextEE facesContext)` Bean 名前解決を委譲する Spring BeanFactory を取得します。
`protected NavigationHandlerEE`	`getDelegate(FacesContextEE facesContext)` 委譲先のターゲット NavigationHandler を返します。
`protected StringSE`	`getTargetBeanName(FacesContextEE facesContext)` BeanFactory 内のターゲット NavigationHandler Bean の名前を返します。
`protected WebApplicationContext`	`getWebApplicationContext(FacesContextEE facesContext)` Bean 名前解決を委譲する Web アプリケーションコンテキストを取得します。
`void`	`handleNavigation(FacesContextEE facesContext, StringSE fromAction, StringSE outcome)` Spring アプリケーションコンテキストでターゲット Bean に委譲することにより、指定されたパラメーターによって暗示されるナビゲーションリクエストを処理します。

クラス javax.faces.application.NavigationHandlerEE から継承されたメソッド
handleNavigationEE

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - DEFAULT_TARGET_BEAN_NAME
```
public static final StringSE DEFAULT_TARGET_BEAN_NAME
```
    Spring アプリケーションコンテキストでのターゲット Bean のデフォルト名: "jsfNavigationHandler"。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - DelegatingNavigationHandlerProxy
```
public DelegatingNavigationHandlerProxy()
```
    新しい DelegatingNavigationHandlerProxy を作成します。
  - DelegatingNavigationHandlerProxy
```
public DelegatingNavigationHandlerProxy(NavigationHandlerEE originalNavigationHandler)
```
    新しい DelegatingNavigationHandlerProxy を作成します。
    パラメーター:
    originalNavigationHandler - オリジナルの NavigationHandler
- メソッドの詳細
  - handleNavigation
```
public void handleNavigation(FacesContextEE facesContext,
                             StringSE fromAction,
                             StringSE outcome)
```
    Spring アプリケーションコンテキストでターゲット Bean に委譲することにより、指定されたパラメーターによって暗示されるナビゲーションリクエストを処理します。
    ターゲット Bean は、JSF NavigationHandler クラスを継承する必要があります。Spring の DecoratingNavigationHandler を継承する場合、引数として元の NavigationHandler を使用したオーバーロードされた handleNavigation メソッドが使用されます。それ以外の場合は、標準の handleNavigation メソッドが呼び出されます。
    次で指定:
    クラス NavigationHandlerEE の handleNavigationEE
  - getDelegate
```
protected NavigationHandlerEE getDelegate(FacesContextEE facesContext)
```
    委譲先のターゲット NavigationHandler を返します。
    デフォルトでは、"jsfNavigationHandler" という名前の Bean は、呼び出しごとに Spring ルート WebApplicationContext から取得されます。
    パラメーター:
    facesContext - 現在の JSF コンテキスト
    戻り値:
    委譲先のターゲット NavigationHandler
    関連事項:
    getTargetBeanName(javax.faces.context.FacesContext), getBeanFactory(javax.faces.context.FacesContext)
  - getTargetBeanName
```
protected StringSE getTargetBeanName(FacesContextEE facesContext)
```
    BeanFactory 内のターゲット NavigationHandler Bean の名前を返します。デフォルトは "jsfNavigationHandler" です。
    パラメーター:
    facesContext - 現在の JSF コンテキスト
    戻り値:
    ターゲット Bean の名前
  - getBeanFactory
```
protected BeanFactory getBeanFactory(FacesContextEE facesContext)
```
    Bean 名前解決を委譲する Spring BeanFactory を取得します。
    デフォルトの実装は getWebApplicationContext に委譲します。オーバーライドして、解決する任意の BeanFactory 参照を提供できます。通常、これは完全な Spring ApplicationContext になります。
    パラメーター:
    facesContext - 現在の JSF コンテキスト
    戻り値:
    Spring BeanFactory (非 null)
    関連事項:
    getWebApplicationContext(javax.faces.context.FacesContext)
  - getWebApplicationContext
```
protected WebApplicationContext getWebApplicationContext(FacesContextEE facesContext)
```
    Bean 名前解決を委譲する Web アプリケーションコンテキストを取得します。
    デフォルトの実装は FacesContextUtils に委譲します。
    パラメーター:
    facesContext - 現在の JSF コンテキスト
    戻り値:
    Spring Web アプリケーションコンテキスト (非 null)
    関連事項:
    FacesContextUtils.getRequiredWebApplicationContext(javax.faces.context.FacesContext)

クラス DelegatingNavigationHandlerProxy

フィールドサマリー

コンストラクターのサマリー

メソッドのサマリー

クラス javax.faces.application.NavigationHandlerEE から継承されたメソッド

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

フィールドの詳細

DEFAULT_TARGET_BEAN_NAME

コンストラクターの詳細

DelegatingNavigationHandlerProxy

DelegatingNavigationHandlerProxy

メソッドの詳細

handleNavigation

getDelegate

getTargetBeanName

getBeanFactory

getWebApplicationContext