パッケージ jakarta.validation
インターフェース Validator
public interface ValidatorBean インスタンスを検証します。このインターフェースの実装はスレッドセーフでなければなりません。- 作成者:
- Emmanuel Bernard, Hardy Ferentschik, Gunnar Morling
方法の概要
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 ExecutableValidatorforExecutables()メソッドとコンストラクターのパラメーターと戻り値を検証するための契約を返します。BeanDescriptorgetConstraintsForClass(ClassSE<?> clazz)Bean 制約を記述する記述子オブジェクトを返します。<T> Tunwrap(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