JSF構成 - <application>要素

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

構文

<application>
  [<action-listener>actionListener</action-listener>]
  [<application-extension>list of proprietary elements</application-extension>]
  [<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>]	
  [<el-resolver>elResolver</el-resolver>]	
  [<resource-bundle>
    [<base-name>basename</base-name>]
    [<var>variablename</var>]
  </resource-bundle>]
  [<locale-config>
    [<default-locale>defLocale</default-locale>]
    [<supported-locale>supLocale</supported-locale>]*
  </locale-config>]
</application>

子要素

<action-listener>
使用方法: アプリケーションに対するデフォルトのアクション・リスナーとして使用されるカスタム・アクション・リスナーを定義します。
値: javax.faces.event.ActionListenerを実装する完全修飾Javaクラス。
<application-extension>
使用方法: アプリケーションの独自の要素を定義します。
値: 独自の要素名と値のリスト。
<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クラス。
<el-resolver>
使用方法: アプリケーションに対するデフォルトとして使用されるカスタムELリゾルバを定義します。
値: javax.el.ELResolverを実装する完全修飾Javaクラス。
<resource-bundle>
アプリケーションにリソース・バンドル(ローカライズされたデータを含む)を設定する場合に使用します。
<locale-config>
デフォルトのロケール、およびアプリケーションでサポートされるロケールを設定する際に使用します。

<resource-bundle>の子要素

<base-name>
使用方法: ローカライズされたアプリケーションのデータを含むリソース・バンドルを定義します。
値: java.util.ResourceBundleインスタンスの完全修飾クラス名。
<var>
使用方法: EL式からリソース・バンドルを参照するための名前を定義します。
値: 任意の変数名。

<locale-config>の子要素

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

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

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

<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構成要素