JSF構成 - <validator>要素

カスタム・バリデータを宣言します。

この要素には、汎用の構成メタデータ要素を子要素として含めることができます。
<attribute>要素を使用して、バリデータの動作に影響を与えるように、対応するUIコンポーネントに対して構成可能な属性を宣言します。
<property>要素を使用して、バリデータ実装の構成可能なJavaBeanプロパティを宣言します。

構文

<validator>
  [<description/>]*
  [<display-name/>]*
  [<icon/>]*
  <validator-id>validatorID</validator-id>
  <validator-class>className</validator-class>
  [<validator-extension>proprietary elements</validator-extension>]  
  [<attribute/>]*
  [<property/>]*
</validator>

子要素

<validator-id>
使用方法: バリデータの識別子を宣言します。
値: 一意の識別子。
例: 識別子に構文prefix.validatorClassを使用すると便利です。
prefix
アプリケーションのJavaパッケージ名の部分を表します。
validatorClass
バリデータのJavaクラスを表します。
たとえば、バリデータ・クラスcom.jsf.validators.ValidateFloatの識別子をcom.validator.Floatに指定できます。
<validator-class>
使用方法: バリデータの実装クラスを宣言します。
値: javax.faces.validator.Validatorを実装する完全修飾Javaクラス。
<validator-extension>
使用方法: カスタム・バリデータに適用する実装固有の要素を格納します。
値: XML要素。

次の例では、入力値をFloatに変換できるカスタム・バリデータを宣言します。

<validator>
  <validator-id>com.validator.Float</validator-id>
  <validator-class>com.jsf.validators.ValidateFloat</validator-class>
</validator> 

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