インターフェース Validator<T>
- 型パラメーター:
T- 検証するオブジェクト値のジェネリクス型。
- すべてのスーパーインターフェース:
EventListenerSE
- すべての既知の実装クラス:
BeanValidator、DoubleRangeValidator、LengthValidator、LongRangeValidator、MethodExpressionValidator、RegexValidator、RequiredValidator
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で説明されているアクションを実行する必要があります。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 voidvalidate(FacesContext context, UIComponent component, T value)
メソッドの詳細
validate
void validate(FacesContext context, UIComponent component, T value) throws ValidatorException
指定された
UIComponentに対してこのValidatorによって実装正しさのチェックを行います。違反が見つかった場合は、障害を説明するFacesMessageを含むValidatorExceptionがスローされます。バリデーターがバージョン 2 以降の仕様に完全に準拠するためには、
nullまたは空の値に対処することを特に意図していない限り、nullまたは空の値の検証に失敗してはなりません。アプリケーション全体の<context-param>は、Jakarta Faces 1.2 用に設計されたバリデーターが Jakarta Faces 2 以降で動作できるようにするために提供されています。この下位互換性の動作を有効にするには、jakarta.faces.VALIDATE_EMPTY_FIELDS<context-param>をfalseに設定する必要があります。- パラメーター:
context- 処理中のリクエストの FacesContextcomponent- 正当性をチェックしている UIComponentvalue- 検証する値- 例外:
ValidatorException- 検証が失敗した場合NullPointerExceptionSE-contextまたはcomponentがnullの場合