リファレンス: JSF構成要素
このリファレンスでは、JSF構成ファイルに設定可能なすべての要素を説明します。次のトピックが含まれます。
- ファイル構造: JSF構成ファイルのフォーム全体。
- 構文に関する注意: 要素を記述するために使用する表記規則。
- 最上位の構成要素: メイン構成要素。リンクをクリックすると、子要素を参照できます。
- メタデータ要素: 他のほとんどの要素が使用する、情報を示す子要素。メタデータ要素は構成に影響を与えません。かわりに、この要素を使用して、構成をドキュメント化し、情報を開発ツールに提供します。
ファイル構造
JSF構成ファイルのXMLスキーマはweb-facesconfig_1_x.xsd
です。次の例は、JSF構成ファイルのルート要素を示しています。
<?xml version="1.0" encoding="windows-1252"?>
<faces-config version="1.2" xmlns="http://java.sun.com/xml/ns/javee">
...
</faces-config>
他のすべての最上位要素は、任意の順序でルート要素内に配置できます。特に指示がないかぎり、要素の複数のインスタンスを含めることができます。
構文に関する注意
最上位要素には子要素が含まれます。たとえば、managed-bean
には、子要素managed-bean-name
が含まれます。子要素は必ず、構文の説明にリストされている順に組み込んでください。
大カッコ([ ]
)内の子要素はオプションです。縦線( |
)で区切られた子要素は相互に排他的です。ネストされた要素の末尾にあるアスタリスク(*
)は、複数の要素を使用できることを意味します。
イタリック体
の値は、ユーザーが指定する値を表します。
最上位の構成要素
要素 |
構文 |
<application> |
<application>
[<action-listener>actionListener</action-listener>]
[<application-extension>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>rbName</base-name>]
[<var>rbVar</var>]
<resource-bundle>]
[<locale-config>
[<default-locale>defLocale</default-locale>]
[<supported-locale>supLocale</supported-locale>]*
<locale-config>]
</application>
|
<component> |
<component>
[< description />]*
[< display-name />]*
[< icon />]*
<component-type>comType</component-type>
<component-class>comClass</component-class>
[<facet>
[< description />]*
[< display-name />]*
[< icon />]*
<facet-name>facetName</facet-name>
[<facet-extension>facetextension</facet-extension>]*
</facet>]*
[< attribute />]*
[< property />]*
[<component-extension>componentExtension</component-extension>
</component>
|
<converter> |
<converter>
[< description />]*
[< display-name />]*
[< icon />]*
<converter-id>converterID</converter-id> |
<converter-for-class>targetClassName</converter-for-class>
<converter-class>className</converter-class>
[<converter-extension>proprietary elements</converter-extension>]
[< attribute />]*
[< property />]*
</converter>
|
<factory> |
<factory>
[<application-factory>appFactory</application-factory>]
[<faces-context-factory>fcFactory</faces-context-factory>]
[<lifecycle-factory>lifeFactory</lifecycle-factory>]
[<render-kit-factory>rkitFactory</render-kit-factory>]
[<factory-extension>proprietary elements</factory-extension>]
</factory> |
<lifecycle> |
<lifecycle>
<phase-listener>phaseListener</phase-listener>
[<lifecycle-extension>proprietary elements</lifecycle-extension>]
</lifecycle>
|
<managed-bean> |
<managed-bean>
[< description />]*
[< display-name />]*
[< icon />]*
<managed-bean-name>beanName</managed-bean-name>
<managed-bean-class>beanClass</managed-bean-class>
<managed-bean-scope>
none | request | session | application
</managed-bean-scope>
[<managed-bean-extension>proprietary elements</managed-bean-extension>]
[< ManagedProperty >*|< MapEntries >|< ListEntries >]
</managed-bean>
ManagedProperty ::=
<managed-property>
[< description />]*
[< display-name />]*
[< icon />]*
<property-name>propertyName</property-name>
[<property-class>propertyClass</property-class>
[< Value >|< MapEntries >|< ListEntries >|< null-value/> ]
</managed-property>
Value ::=
<value>simplevalue</value>
MapEntries ::=
<map-entries>
[<key-class>KeyClass</key-class>]
[<value-class>valueClass</value-class>]
<map-entry>
<key>key</key>
<value>value</value> | null-value/>
</map-entry>*
</map-entries>
ListEntries ::=
<list-entries>
[<value-class>valueClass</value-class>]
<value>value</value> | <null-value/>*
</list-entries>
|
<navigation-rule> |
<navigation-rule>
[< description />]*
[< display-name />]*
[< icon />]*
[<from-view-id>viewId</from-view-id>]
[<navigation-case>
[< description />]*
[< display-name />]*
[< icon />]*
[<from-action>fromActionBinding</from-action>]
[<from-outcome>fromOutcome</from-outcome>]
<to-view-id>viewId</to-view-id>
[<redirect/>]
</navigation-case>]*
[<navigation-rule-extension>proprietary elements</navigation-rule-extension>]
</navigation-rule>
|
<referenced-bean> |
<referenced-bean>
[< description />]*
[< display-name />]*
[< icon />]*
<referenced-bean-name>beanName</referenced-bean-name>
<referenced-bean-class>beanClass</referenced-bean-class>
</referenced-bean>
|
<render-kit> |
<render-kit>
[< description />]*
[< display-name />]*
[< icon />]*
[<render-kit-id>kitId</render-kit-id>]
[<render-kit-class>kitClass</render-kit-class>]
[<render-kit-extension>proprietary elements</render-kit-extension>]
[<renderer>
[< description />]*
[< display-name />]*
[< icon />]*
<component-family>componentFamily</component-family>
<renderer-type>rendererType</renderer-type>]
<renderer-class>rendererClass</renderer-class>]
[<facet>
[< description />]*
[< display-name />]*
[< icon />]*
<facet-name>facetName</facet-name>
[<facet-extension>facetextension</facet-extension>]*
</facet>]*
[< attribute >]*
[<renderer-extension>
renextension
</renderer-extension>]*
</renderer>]*
</render-kit>
|
<validator> |
<validator>
[< description />]*
[< display-name />]*
[< icon />]*
<validator-id>validatorID</validator-id>
<validator-class>className</validator-class>
[<validator-extension>proprietary elements</validator-extension>]
[< attribute >]*
[< property >]*
</validator>
|
<faces-config-extension> |
<faces-config-extension>list of proprietary elements</faces-config-extension>
|
メタデータ要素
要素 |
構文 |
<description> |
<description[xml:lang="lang"]>descriptive_metadata</description>
|
<display-name> |
<display-name[xml:lang="lang"]>displayed_metadata</display-name>
|
<icon> |
<icon[xml:lang="lang"]>
[<small-icon>iconPath</small-icon>]
[<large-icon>iconPath</large-icon>]
</icon>
|
<attribute> |
<attribute>
[< description />]*
[< display-name />]*
[< icon />]*
<attribute-name>attributeName</attribute-name>
<attribute-class>attributeClass</attribute-class>
[<default-value>defaultValue</default-value>]
[<suggested-value>suggestedValue</suggested-value>]
[<attribute-extension>
attrExtension
</attribute-extension>]
</attribute>
|
<property> |
<property>
[< description />]*
[< display-name />]*
[< icon />]*
<property-name>propertyName</property-name>
<property-class>propertyClass</property-class>
[<default-value>defaultValue</default-value>]
[<suggested-value>suggestedValue</suggested-value>]
[<property-extension>propExtension</property-extension>]
</property>
|
関連項目
JSFアプリケーションの構成
JSFでのエラー・メッセージの表示およびカスタマイズ
JSFでのイベントおよびイベント・リスナーの使用
コンポーネント・バインディングの使用
JavaServer Facesの使用
Copyright © 1997, 2009, Oracle. All rights reserved.