パッケージ jakarta.validation

インターフェース Validator


  • public interface Validator
    Bean インスタンスを検証します。このインターフェースの実装はスレッドセーフでなければなりません。
    作成者:
    Emmanuel Bernard, Hardy Ferentschik, Gunnar Morling
    • メソッドの詳細

      • validate

        <T> SetSE<ConstraintViolation<T>> validate​(T object,
                                                 ClassSE<?>... groups)
        object のすべての制約を検証します。
        型パラメーター:
        T - 検証するオブジェクトの型
        パラメーター:
        object - 検証するオブジェクト
        groups - 検証の対象となるグループまたはグループのリスト (デフォルトは Default )
        戻り値:
        制約違反またはない場合は空のセット
        例外:
        IllegalArgumentExceptionSE - オブジェクトが null である場合、または null が可変引数グループに渡される場合
        ValidationException - 検証プロセス中に回復不能なエラーが発生した場合
      • validateProperty

        <T> SetSE<ConstraintViolation<T>> validateProperty​(T object,
                                                         StringSE propertyName,
                                                         ClassSE<?>... groups)
        propertyName という名前の object のプロパティに配置されたすべての制約を検証します。
        型パラメーター:
        T - 検証するオブジェクトの型
        パラメーター:
        object - 検証するオブジェクト
        propertyName - 検証するプロパティ (つまり、フィールドと getter の制約)
        groups - 検証の対象となるグループまたはグループのリスト (デフォルトは Default )
        戻り値:
        制約違反またはない場合は空のセット
        例外:
        IllegalArgumentExceptionSE - object が null の場合、propertyName が null の場合、空または有効なオブジェクトプロパティではないか、null が可変引数グループに渡された場合
        ValidationException - 検証プロセス中に回復不能なエラーが発生した場合
      • validateValue

        <T> SetSE<ConstraintViolation<T>> validateValue​(ClassSE<T> beanType,
                                                      StringSE propertyName,
                                                      ObjectSE value,
                                                      ClassSE<?>... groups)
        プロパティ値が value であるクラス beanType の propertyName という名前のプロパティに配置されたすべての制約を検証します。

        ConstraintViolation オブジェクトは、ConstraintViolation.getRootBean() および ConstraintViolation.getLeafBean() に対して null を返します。

        型パラメーター:
        T - 検証するオブジェクトの型
        パラメーター:
        beanType - Bean 型
        propertyName - 検証するプロパティ
        value - 検証するプロパティ値
        groups - 検証の対象となるグループまたはグループのリスト(デフォルトは Default)。
        戻り値:
        制約違反またはない場合は空のセット
        例外:
        IllegalArgumentExceptionSE - beanType が null の場合、propertyName が null の場合、空または有効なオブジェクトプロパティではないか、null が可変引数グループに渡された場合
        ValidationException - 検証プロセス中に回復不能なエラーが発生した場合
      • getConstraintsForClass

        BeanDescriptor getConstraintsForClass​(ClassSE<?> clazz)
        Bean 制約を記述する記述子オブジェクトを返します。

        返されたオブジェクト(および ConstraintDescriptor を含む関連オブジェクト)は不変です。

        パラメーター:
        clazz - 評価されたクラスまたはインターフェースの型
        戻り値:
        指定されたクラスの Bean 記述子
        例外:
        IllegalArgumentExceptionSE - clazz が null の場合
        ValidationException - メタデータの検出中に回復不可能なエラーが発生した場合、または一部の制約が無効な場合。
      • unwrap

        <T> T unwrap​(ClassSE<T> type)
        プロバイダー固有の API へのアクセスを許可する、指定された型のインスタンスを返します。

        Jakarta Bean Validation プロバイダーの実装が指定されたクラスをサポートしない場合、ValidationException がスローされます。

        型パラメーター:
        T - 返されるオブジェクトの型
        パラメーター:
        type - 返されるオブジェクトのクラス
        戻り値:
        指定されたクラスのインスタンス
        例外:
        ValidationException - プロバイダーが呼び出しをサポートしていない場合
      • forExecutables

        ExecutableValidator forExecutables()
        メソッドとコンストラクターのパラメーターと戻り値を検証するための契約を返します。
        戻り値:
        メソッドとコンストラクターの検証の契約
        導入:
        1.1