パッケージ 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 Validation プロバイダーの実装が指定されたクラスをサポートしない場合、ValidationException がスローされます。

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

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