javax.validation.executable
Interface ExecutableValidator

public interface ExecutableValidator

Validates parameters and return values of methods and constructors. Implementations of this interface must be thread-safe.

Since:

1.1

Author:

Gunnar Morling

Method Summary

<T> Set<ConstraintViolation<T>>	validateConstructorParameters(Constructor<? extends T> constructor, Object[] parameterValues, Class<?>... groups) Validates all constraints placed on the parameters of the given constructor.
<T> Set<ConstraintViolation<T>>	validateConstructorReturnValue(Constructor<? extends T> constructor, T createdObject, Class<?>... groups) Validates all return value constraints of the given constructor.
<T> Set<ConstraintViolation<T>>	validateParameters(T object, Method method, Object[] parameterValues, Class<?>... groups) Validates all constraints placed on the parameters of the given method.
<T> Set<ConstraintViolation<T>>	validateReturnValue(T object, Method method, Object returnValue, Class<?>... groups) Validates all return value constraints of the given method.

Method Detail

validateParameters

<T> Set<ConstraintViolation<T>> validateParameters(T object,
                                                   Method method,
                                                   Object[] parameterValues,
                                                   Class<?>... groups)

Validates all constraints placed on the parameters of the given method.

Type Parameters:

T - The type hosting the method to validate.

Parameters:

object - The object on which the method to validate was invoked.

method - The method for which the parameter constraints shall be validated.

parameterValues - The values provided by the caller for the given method's parameters.

groups - The group or list of groups targeted for validation (defaults to Default).

Returns:

A set with the constraint violations caused by this validation. Will be empty, if no error occurs, but never null.

Throws:

IllegalArgumentException - if null is passed for any of the parameters

ValidationException - if a non recoverable error happens during the validation process

validateReturnValue

<T> Set<ConstraintViolation<T>> validateReturnValue(T object,
                                                    Method method,
                                                    Object returnValue,
                                                    Class<?>... groups)

Validates all return value constraints of the given method. Throws a ValidationException if the method has no return value.

Type Parameters:

T - The type hosting the method to validate.

Parameters:

object - The object on which the method to validate was invoked.

method - The method for which the return value constraints shall be validated.

returnValue - The value returned by the given method.

groups - The group or list of groups targeted for validation (defaults to Default).

Returns:

A set with the constraint violations caused by this validation. Will be empty, if no error occurs, but never null.

Throws:

IllegalArgumentException - if null is passed for any of the object, method or groups parameters

ValidationException - if a non recoverable error happens during the validation process

validateConstructorParameters

<T> Set<ConstraintViolation<T>> validateConstructorParameters(Constructor<? extends T> constructor,
                                                              Object[] parameterValues,
                                                              Class<?>... groups)

Validates all constraints placed on the parameters of the given constructor.

Type Parameters:

T - The type hosting the constructor to validate.

Parameters:

constructor - The constructor for which the parameter constraints shall be validated.

parameterValues - The values provided by the caller for the given constructor's parameters.

groups - The group or list of groups targeted for validation (defaults to Default).

Returns:

A set with the constraint violations caused by this validation. Will be empty, if no error occurs, but never null.

Throws:

IllegalArgumentException - if null is passed for any of the parameters

ValidationException - if a non recoverable error happens during the validation process

validateConstructorReturnValue

<T> Set<ConstraintViolation<T>> validateConstructorReturnValue(Constructor<? extends T> constructor,
                                                               T createdObject,
                                                               Class<?>... groups)

Validates all return value constraints of the given constructor.

Type Parameters:

T - The type hosting the constructor to validate.

Parameters:

constructor - The constructor for which the return value constraints shall be validated.

createdObject - The object instantiated by the given method.

groups - The group or list of groups targeted for validation (defaults to Default).

Returns:

A set with the constraint violations caused by this validation. Will be empty, if no error occurs, but never null.

Throws:

IllegalArgumentException - if null is passed for any of the parameters

ValidationException - if a non recoverable error happens during the validation process