javax.validation
Interface Validator


public interface Validator

Validate bean instances. Implementations of this interface must be thread-safe.

Author:
Emmanuel Bernard, Hardy Ferentschik

Method Summary
 BeanDescriptor getConstraintsForClass(java.lang.Class<?> clazz)
          Return the descriptor object describing bean constraints.
<T> T
unwrap(java.lang.Class<T> type)
          Return an instance of the specified type allowing access to provider-specific APIs.
<T> java.util.Set<ConstraintViolation<T>>
validate(T object, java.lang.Class<?>... groups)
          Validates all constraints on object.
<T> java.util.Set<ConstraintViolation<T>>
validateProperty(T object, java.lang.String propertyName, java.lang.Class<?>... groups)
          Validates all constraints placed on the property of object named propertyName.
<T> java.util.Set<ConstraintViolation<T>>
validateValue(java.lang.Class<T> beanType, java.lang.String propertyName, java.lang.Object value, java.lang.Class<?>... groups)
          Validates all constraints placed on the property named propertyName of the class beanType would the property value be value

ConstraintViolation objects return null for ConstraintViolation#getRootBean() and ConstraintViolation#getLeafBean()

 

Method Detail

validate

<T> java.util.Set<ConstraintViolation<T>> validate(T object,
                                                   java.lang.Class<?>... groups)
Validates all constraints on object.

Parameters:
object - object to validate
groups - group or list of groups targeted for validation (default to Default)
Returns:
constraint violations or an empty Set if none
Throws:
IllegalArgumentException - if object is null or if null is passed to the varargs groups
ValidationException - if a non recoverable error happens during the validation process

validateProperty

<T> java.util.Set<ConstraintViolation<T>> validateProperty(T object,
                                                           java.lang.String propertyName,
                                                           java.lang.Class<?>... groups)
Validates all constraints placed on the property of object named propertyName.

Parameters:
object - object to validate
propertyName - property to validate (ie field and getter constraints)
groups - group or list of groups targeted for validation (default to Default)
Returns:
constraint violations or an empty Set if none
Throws:
IllegalArgumentException - if object is null, if propertyName null, empty or not a valid object property or if null is passed to the varargs groups
ValidationException - if a non recoverable error happens during the validation process

validateValue

<T> java.util.Set<ConstraintViolation<T>> validateValue(java.lang.Class<T> beanType,
                                                        java.lang.String propertyName,
                                                        java.lang.Object value,
                                                        java.lang.Class<?>... groups)
Validates all constraints placed on the property named propertyName of the class beanType would the property value be value

ConstraintViolation objects return null for ConstraintViolation#getRootBean() and ConstraintViolation#getLeafBean()

Parameters:
beanType - the bean type
propertyName - property to validate
value - property value to validate
groups - group or list of groups targeted for validation (default to Default)
Returns:
constraint violations or an empty Set if none
Throws:
IllegalArgumentException - if beanType is null, if propertyName null, empty or not a valid object property or if null is passed to the varargs groups
ValidationException - if a non recoverable error happens during the validation process

getConstraintsForClass

BeanDescriptor getConstraintsForClass(java.lang.Class<?> clazz)
Return the descriptor object describing bean constraints. The returned object (and associated objects including ConstraintDescriptors) are immutable.

Parameters:
clazz - class or interface type evaluated
Returns:
the bean descriptor for the specified class.
Throws:
IllegalArgumentException - if clazz is null
ValidationException - if a non recoverable error happens during the metadata discovery or if some constraints are invalid.

unwrap

<T> T unwrap(java.lang.Class<T> type)
Return an instance of the specified type allowing access to provider-specific APIs. If the Bean Validation provider implementation does not support the specified class, ValidationException is thrown.

Parameters:
type - the class of the object to be returned.
Returns:
an instance of the specified class
Throws:
ValidationException - if the provider does not support the call.


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41

Scripting on this page tracks web page traffic, but does not change the content in any way.