javax.validation.Validator Maven / Gradle / Ivy
/*
* Copyright © 2018 The GWT Authors
*
* 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 group or list of 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 of object named
* propertyName.
*
* @param object object to validate
* @param propertyName property to validate (ie field and getter constraints)
* @param groups group or list of 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 of the class
* beanType 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 group or list of 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 or interface 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 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.
*
* @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);
}