T - 検証するオブジェクト値のジェネリクス型。public interface Validator<T> extends EventListenerSE
Validator 実装は、EditableValueHolder で検証（正当性チェック）を実行できるクラスです。0 個以上の Validator をビュー内の各 EditableValueHolder に関連付けることができ、リクエスト処理ライフサイクルのプロセス検証フェーズ中に呼び出されます。
個々の Validator は、渡された値とコンポーネントを調べ、必要なルールに準拠するための失敗をドキュメント化して、FacesMessage を含む ValidatorException をスローする必要があります。
一般性を最大にするために、Validator インスタンスは、Validator 実装クラスのプロパティに基づいて構成可能です。例: 範囲チェック Validator は、使用する最小値と最大値の構成をサポートする場合があります。
Validator 実装には、引数なしの public コンストラクターが必要です。さらに、Validator クラスがビューとともに保存および復元される構成プロパティ値を必要とする場合、実装は StateHolder も実装する必要があります。
Validator を実装するクラスに ResourceDependency アノテーションがある場合、EditableValueHolder.addValidator(jakarta.faces.validator.Validator) が呼び出されたときに、ResourceDependency で説明されているアクションを実行する必要があります。Validator を実装するクラスに ResourceDependencies アノテーションがある場合、EditableValueHolder.addValidator(jakarta.faces.validator.Validator) が呼び出されたときに、ResourceDependencies で説明されているアクションを実行する必要があります。
| 修飾子と型 | フィールドと説明 |
|---|---|
static StringSE | NOT_IN_RANGE_MESSAGE_ID 使用すべきではありません。 |
| 修飾子と型 | メソッドと説明 |
|---|---|
void | validate(FacesContext context, UIComponent component, T value) |
@DeprecatedSE static final StringSE NOT_IN_RANGE_MESSAGE_ID
DoubleRangeValidator.NOT_IN_RANGE_MESSAGE_ID または LongRangeValidator.NOT_IN_RANGE_MESSAGE_ID を使用してください。 最大値または最小値のチェックが失敗し、このバリデーターの最大値と最小値の両方が設定されている場合に作成される FacesMessage のメッセージ識別子。このメッセージのメッセージ形式文字列には、オプションで、構成された最小値に置き換えられる {0} プレースホルダーと、構成された最大値に置き換えられる {1} プレースホルダーを含めることができます。
void validate(FacesContext context, UIComponent component, T value) throws ValidatorException
指定された UIComponent に対してこの Validator によって実装正しさのチェックを行います。違反が見つかった場合は、障害を説明する FacesMessage を含む ValidatorException がスローされます。
バリデーターがバージョン 2 以降の仕様に完全に準拠するためには、null または空の値に対処することを特に意図していない限り、null または空の値の検証に失敗してはなりません。アプリケーション全体の <context-param> は、Jakarta Server Faces 1.2 用に設計されたバリデーターが Jakarta Server Faces 2 以降で動作できるようにするために提供されています。この下位互換性の動作を有効にするには、jakarta.faces.VALIDATE_EMPTY_FIELDS <context-param> を false に設定する必要があります。
context - 処理中のリクエストの FacesContextcomponent - 正当性をチェックしている UIComponentvalue - 検証する値 ValidatorException - 検証が失敗した場合 NullPointerExceptionSE - context または component が null の場合 Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.