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(javax.faces.validator.Validator)
が呼び出されたときに、ResourceDependency
で説明されているアクションを実行する必要があります。Validator
を実装するクラスに ResourceDependencies
アノテーションがある場合、EditableValueHolder.addValidator(javax.faces.validator.Validator)
が呼び出されたときに、ResourceDependencies
で説明されているアクションを実行する必要があります。
修飾子と型 | フィールドと説明 |
---|---|
static StringSE | NOT_IN_RANGE_MESSAGE_ID 使用すべきではありません。 |
修飾子と型 | メソッドと説明 |
---|---|
void | validate(FacesContext context, UIComponent component, T value) |
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 以降で動作できるようにするために提供されています。この下位互換性の動作を有効にするには、javax.faces.VALIDATE_EMPTY_FIELDS
<context-param>
を false
に設定する必要があります。
context
- 処理中のリクエストの FacesContextcomponent
- 正当性をチェックしている UIComponentvalue
- 検証する値 ValidatorException
- 検証が失敗した場合 NullPointerExceptionSE
- context
または component
が null
の場合 Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.