JSF構成 - <property>要素

親要素の関連のJavaBeanプロパティとプロパティ拡張に関する情報を宣言します。この情報は構成に影響を与えず、メタデータとして使用されます。この要素は次の要素内で有効です。

構文

<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>

要素

<property-name>
使用方法: プロパティの名前を宣言します。
値: 親要素の有効範囲内で一意の識別子。
<property-class>
使用方法: プロパティのデータ型をJavaクラスとして宣言します。
値: プロパティのデータ型の完全修飾Javaクラス名。
<default-value>
使用方法: プロパティが戻す値(まだ設定されていない場合)を宣言します。
値: プロパティの型に変換可能な値の文字列表現。
<suggested-value>
使用方法: プロパティで使用する推奨値を宣言します。
値: プロパティの型に変換可能な値の文字列表現。
<property-extension>
使用方法: <property>の親要素に適用する実装固有の要素を格納します。
値: XML要素。

次の例では、カスタム・コンポーネントSliderのプロパティorientationを宣言します。アプリケーション開発ツールでは、この宣言を読み取り、orientationプロパティ(デフォルト値は"horizontal")を持つ使用可能なコンポーネントとしてSliderを表示します。

<component>
  <display-name>Slider</display-name>
  <component-type>com.component.Slider</component-type>
  <component-class>com.jsf.components.Slider</component-class>
  <property>
    <property-name>orientation</property-name>
    <property-class>java.lang.String</property-class>
    <default-value>horizontal</default-value>
    <suggested-value>horizontal</suggested-value>
  </property>
</component>

<description>要素
<display-name>要素
<icon>要素
リファレンス: JSF構成要素