パッケージ jakarta.faces.validator

アノテーション型 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() へのそのようなすべての呼び出しが、アプリケーションの起動時およびリクエストが処理される前に発生することを保証する必要があります。

    • オプション要素のサマリー

      オプション要素  
      修飾子と型 オプションの要素 説明
      booleanisDefault
      true の場合、このアノテーションのバリデータ ID は、Application.addDefaultValidatorId(java.lang.String) の呼び出しによってデフォルトのバリデータのリストに追加されます。
      booleanmanaged
      このアノテーション属性の値は、指定されたコンバーターが CDI 管理のコンバーターであるかどうかを示すインジケーターとして解釈されます。
      StringSEvalue
      このアノテーション属性の 値は、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
      • managed

        boolean managed

        このアノテーション属性の値は、指定されたコンバーターが CDI 管理のコンバーターであるかどうかを示すインジケーターとして解釈されます。

        戻り値:
        CDI が管理している場合は true、それ以外の場合は false。
        デフォルト:
        false