javax.validation.Validator Maven / Gradle / Ivy
// $Id: Validator.java 17028 2009-07-07 20:23:05Z epbernard $
/*
* JBoss, Home of Professional Open Source
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package javax.validation;
import java.util.Set;
import javax.validation.metadata.BeanDescriptor;
/**
* Validate bean instances. Implementations of this interface must be thread-safe.
*
* @author Emmanuel Bernard
* @author Hardy Ferentschik
*/
public interface Validator {
/**
* Validates all constraints on object.
*
* @param object object to validate
* @param groups groups targeted for validation
* (default to {@link javax.validation.groups.Default})
*
* @return constraint violations or an empty Set if none
*
* @throws IllegalArgumentException if object is null
* or if null is passed to the varargs groups
* @throws ValidationException if a non recoverable error happens
* during the validation process
*/
Set> validate(T object, Class... groups);
/**
* Validates all constraints placed on the property named propertyName
* of object
*
* @param object object to validate
* @param propertyName property to validate (ie field and getter constraints)
* @param groups groups targeted for validation
* (default to {@link javax.validation.groups.Default})
*
* @return 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
* @throws ValidationException if a non recoverable error happens
* during the validation process
*/
Set> validateProperty(T object,
String propertyName,
Class... groups);
/**
* Validates all constraints placed on the property named propertyName
* would the property value be value
*
* ConstraintViolation objects return null for
* {@link ConstraintViolation#getRootBean()} and {@link ConstraintViolation#getLeafBean()}
*
* @param beanType the bean type
* @param propertyName property to validate
* @param value property value to validate
* @param groups groups targeted for validation
* (default to {@link javax.validation.groups.Default})
*
* @return 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
* @throws ValidationException if a non recoverable error happens
* during the validation process
*/
Set> validateValue(Class beanType,
String propertyName,
Object value,
Class... groups);
/**
* Return the descriptor object describing bean constraints
* The returned object (and associated objects including ConstraintDescriptors)
* are immutable.
*
* @param clazz class type evaluated
*
* @return the bean descriptor for the specified class.
*
* @throws IllegalArgumentException if clazz is null
* @throws ValidationException if a non recoverable error happens
* during the metadata discovery or if some
* constraints are invalid.
*/
BeanDescriptor getConstraintsForClass(Class clazz);
/**
* Return an object of the specified type to allow access to the
* provider-specific API. If the Bean Validation provider
* implementation does not support the specified class, the
* ValidationException is thrown.
*
* @param type the class of the object to be returned.
*
* @return an instance of the specified class
*
* @throws ValidationException if the provider does not
* support the call.
*/
public T unwrap(Class type);
}