アノテーション型 FacesValidator
@RetentionSE(RUNTIMESE) @TargetSE({TYPESE,FIELDSE,METHODSE,PARAMETERSE}) @InheritedSE @Qualifier public @interface FacesValidator
クラスにこのアノテーションが存在すると、そのクラスがランタイムに
Validator
として自動的に登録されます。value()
属性の値は validator-id と見なされ、このアノテーションが付加されるクラスの完全修飾クラス名は validator-class と見なされます。実装では、*FacesValidator
でアノテーションが付けられた各クラスについて、Jakarta Faces Specification Document のセクション 11.4「アプリケーション構成リソース内のエントリに対応し、そのエントリに取って代わる可能性があるアノテーション」で見つかったApplication.addValidator(java.lang.String,java.lang.String)
が呼び出され、派生バリデータを渡すことを保証する必要があります。-id を最初の引数として、派生したバリデータクラスを 2 番目の引数として指定します。実装では、addValidator()
へのそのようなすべての呼び出しが、アプリケーションの起動時およびリクエストが処理される前に発生することを保証する必要があります。
オプション要素のサマリー
オプション要素 修飾子と型 オプションの要素 説明 boolean
isDefault
true
の場合、このアノテーションのバリデータ ID は、Application.addDefaultValidatorId(java.lang.String)
の呼び出しによってデフォルトのバリデータのリストに追加されます。boolean
managed
このアノテーション属性の値は、指定されたコンバーターが CDI 管理のコンバーターであるかどうかを示すインジケーターとして解釈されます。StringSE
value
このアノテーション属性の 値は、Application.createValidator(java.lang.String)
を呼び出すことによってこのクラスのコンポーネントのインスタンスをインスタンス化できる validator-id と見なされます。
要素の詳細
value
StringSE value
このアノテーション属性の 値は、
Application.createValidator(java.lang.String)
を呼び出すことによってこのクラスのコンポーネントのインスタンスをインスタンス化できる validator-id と見なされます。値が指定されていない場合、または値がnull
の場合、値は、このアノテーションが付加されているクラスでgetSimpleName
を呼び出し、最初の文字を小文字にしたものと見なされます。この派生名を持つ複数のバリデーターが見つかった場合、結果は未定義です。- 戻り値:
- バリデータ ID
- デフォルト:
- ""
isDefault
boolean isDefault
true
の場合、このアノテーションのバリデータ ID は、Application.addDefaultValidatorId(java.lang.String)
の呼び出しによってデフォルトのバリデータのリストに追加されます。- 戻り値:
- これがデフォルトのバリデーターであるかどうか
- デフォルト:
- false