JSF構成 - <application>要素

アプリケーションの交換可能なカスタム・アーチファクトを宣言します。子要素は任意の順序で宣言できます。宣言されていない要素では、JSF参照実装で設定されているデフォルトが使用されます。

<locale-config>要素には、デフォルトおよびサポート対象の全ロケールを判断するのに使用する子要素が含まれます。

構文

<application>
  [<action-listener>actionListener</action-listener>]
  [<default-render-kit-id>defRenderKit</default-render-kit-id>]
  [<message-bundle>msgBundle</message-bundle>]
  [<navigation-handler>navHandler</navigation-handler>]
  [<view-handler>viewHandler</view-handler>]
  [<state-manager>stManager</state-manager>]
  [<property-resolver>propResolver</property-resolver>]	
  [<variable-resolver>varResolver</variable-resolver>]	
  [<locale-config>
    [<default-locale>defLocale</default-locale>]
    [<supported-locale>supLocale</supported-locale>]*
   </locale-config>]
</application>    

子要素

<action-listener>
使用方法: アプリケーションに対するデフォルトのアクション・リスナーとして使用されるカスタム・アクション・リスナーを定義します。
値: javax.faces.event.ActionListenerを実装する完全修飾Javaクラス。
<default-render-kit-id>
使用方法: アプリケーションに対するデフォルトとして使用されるレンダー・キットを定義します。
値: 構成内の任意の場所で定義されたカスタム・レンダー・キットのレンダー・キットID(<render-kit-id>要素で定義されます)。詳細は、「<render-kit>要素」を参照してください。
<message-bundle>
使用方法: JSF標準メッセージのカスタム・メッセージ・テキストを定義します。
値: メッセージを提供するメッセージ・リソース・バンドルのベース名。
<navigation-handler>
使用方法: アプリケーションに対するデフォルトとして使用されるカスタム・ナビゲーション・ハンドラを定義します。
値: javax.faces.application.NavigationHandlerを実装する完全修飾Javaクラス。
<view-handler>
使用方法: アプリケーションに対するデフォルトとして使用されるカスタム・ビュー・ハンドラを定義します。
値: javax.faces.application.ViewHandlerを実装する完全修飾Javaクラス。
<state-manager>
使用方法: アプリケーションに対するデフォルトとして使用されるカスタムの状態マネージャを定義します。
値: javax.faces.application.StateManagerを実装する完全修飾Javaクラス。
<property-resolver>
使用方法: アプリケーションに対するデフォルトとして使用されるカスタム・プロパティ・リゾルバを定義します。
値: javax.faces.application.PropertyResolverを実装する完全修飾Javaクラス。
<variable-resolver>
使用方法: アプリケーションに対するデフォルトとして使用されるカスタムの変数リゾルバを定義します。
値: javax.faces.application.VariableResolverを実装する完全修飾Javaクラス。
<locale-config>
デフォルトのロケール、およびアプリケーションでサポートされるロケールを設定する際に使用します。

<locale-config>の子要素

<default-locale>
使用方法: デフォルトのロケールを定義します。使用できるのは1つのインスタンスのみです。
値: ISOロケール・コード。:language:[_:country:[_:variant:]](コロンは付けない)のように指定します(例: ja-JP-SJIS)。セグメント間のセパレータには、「-」または「_」を使用できます。

<supported-locale>
使用方法: サポート対象のロケールを定義します。複数のインスタンスを使用できます。
値: ISOロケール・コード。:language:[_:country:[_:variant:]](コロンは付けない)のように指定します(例: ja-JP-SJIS)。セグメント間のセパレータには、「-」または「_」を使用できます。

次の例では、アプリケーションのデフォルトのロケールがアメリカ英語であること、およびアプリケーションで英語(アメリカ)、フランス語(フランス)、ドイツ語(ドイツ)およびポルトガル語(ブラジル)がサポートされることを宣言します。

<application>
  <locale-config>
    <default-locale>en-US</default-locale>
    <supported-locale>fr-FR</supported-locale>
    <supported-locale>de-DE</supported-locale>
    <supported-locale>pt-BR</supported-locale>
  </locale-config
</application>    

JSFアプリケーション要素の構成
リファレンス: JSF構成要素