パッケージ jakarta.validation
インターフェース Validator
public interface Validator
Bean インスタンスを検証します。このインターフェースの実装はスレッドセーフでなければなりません。
- 作成者:
- Emmanuel Bernard, Hardy Ferentschik, Gunnar Morling
方法の概要
修飾子と型メソッド説明メソッドとコンストラクターのパラメーターと戻り値を検証するための契約を返します。getConstraintsForClass(ClassSE<?> clazz) Bean 制約を記述する記述子オブジェクトを返します。<T> Tプロバイダー固有の API へのアクセスを許可する、指定された型のインスタンスを返します。<T> SetSE<ConstraintViolation<T>>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
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
Bean 制約を記述する記述子オブジェクトを返します。返されたオブジェクト(および
ConstraintDescriptorを含む関連オブジェクト)は不変です。- パラメーター:
clazz- 評価されたクラスまたはインターフェースの型- 戻り値:
- 指定されたクラスの Bean 記述子
- 例外:
IllegalArgumentExceptionSE- clazz がnullの場合ValidationException- メタデータの検出中に回復不可能なエラーが発生した場合、または一部の制約が無効な場合。
unwrap
プロバイダー固有の API へのアクセスを許可する、指定された型のインスタンスを返します。Jakarta Validation プロバイダーの実装が指定されたクラスをサポートしない場合、
ValidationExceptionがスローされます。- 型パラメーター:
T- 返されるオブジェクトの型- パラメーター:
type- 返されるオブジェクトのクラス- 戻り値:
- 指定されたクラスのインスタンス
- 例外:
ValidationException- プロバイダーが呼び出しをサポートしていない場合
forExecutables
ExecutableValidator forExecutables()メソッドとコンストラクターのパラメーターと戻り値を検証するための契約を返します。- 戻り値:
- メソッドとコンストラクターの検証の契約
- 導入:
- 1.1