パッケージ jakarta.validation
インターフェース Validator
public interface Validator
Bean インスタンスを検証します。このインターフェースの実装はスレッドセーフでなければなりません。- 作成者:
- Emmanuel Bernard, Hardy Ferentschik, Gunnar Morling
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 ExecutableValidator
forExecutables()
メソッドとコンストラクターのパラメーターと戻り値を検証するための契約を返します。BeanDescriptor
getConstraintsForClass(ClassSE<?> clazz)
Bean 制約を記述する記述子オブジェクトを返します。<T> T
unwrap(ClassSE<T> type)
プロバイダー固有の API へのアクセスを許可する、指定された型のインスタンスを返します。<T> SetSE<ConstraintViolation<T>>
validate(T object, ClassSE<?>... groups)
object
のすべての制約を検証します。<T> SetSE<ConstraintViolation<T>>
validateProperty(T object, StringSE propertyName, ClassSE<?>... groups)
propertyName
という名前のobject
のプロパティに配置されたすべての制約を検証します。<T> SetSE<ConstraintViolation<T>>
validateValue(ClassSE<T> beanType, StringSE propertyName, ObjectSE value, ClassSE<?>... groups)
プロパティ値がvalue
であるクラスbeanType
のpropertyName
という名前のプロパティに配置されたすべての制約を検証します。
メソッドの詳細
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