com.google.gwt.validation.client.impl.GwtSpecificValidator Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of vaadin-client Show documentation
Show all versions of vaadin-client Show documentation
Vaadin is a web application framework for Rich Internet Applications (RIA).
Vaadin enables easy development and maintenance of fast and
secure rich web
applications with a stunning look and feel and a wide browser support.
It features a server-side architecture with the majority of the logic
running
on the server. Ajax technology is used at the browser-side to ensure a
rich
and interactive user experience.
/*
* Copyright 2010 Google Inc.
*
* 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 com.google.gwt.validation.client.impl;
import com.google.gwt.validation.client.impl.metadata.BeanMetadata;
import com.google.gwt.validation.client.impl.metadata.ValidationGroupsMetadata;
import java.util.Set;
import javax.validation.ConstraintViolation;
import javax.validation.ValidationException;
/**
* Defines GWT version of {@link javax.validation.Validator}. This used by
* generate a specific Validator for a given class G.
*
* @param the type of bean for this validator
*/
public interface GwtSpecificValidator {
/**
* Helper method used to first expand the Default group sequence and then
* perform validation of a bean using the specific group(s).
* @param context GWT validation context.
* @param object Object being validated.
* @param violations Set of violations to add to.
* @param groups What group(s) to validate.
*/
void expandDefaultAndValidateClassGroups(
GwtValidationContext context,
G object,
Set> violations,
Group... groups);
/**
* Helper method used to first expand the Default group sequence and then
* perform validation of a bean using the specific group(s).
* @param context GWT validation context.
* @param object Object being validated.
* @param propertyName The name of the property being validated.
* @param violations Set of violations to add to.
* @param groups What group(s) to validate.
*/
void expandDefaultAndValidatePropertyGroups(
GwtValidationContext context,
G object,
String propertyName,
Set> violations,
Group... groups);
/**
* Helper method used to first expand the Default group sequence and then
* perform validation of a bean using the specific group(s).
* @param context GWT validation context.
* @param beanType Class being validated.
* @param propertyName The name of the property being validated.
* @param value The value of the property to use.
* @param violations Set of violations to add to.
* @param groups What group(s) to validate.
*/
void expandDefaultAndValidateValueGroups(
GwtValidationContext context,
Class beanType,
String propertyName,
Object value,
Set> violations,
Group... groups);
/**
* @return The metadata for the bean class associated with this valdiator.
*/
BeanMetadata getBeanMetadata();
/**
* Return the descriptor object describing bean constraints. The returned
* object (and associated objects including
* ConstraintDescriptors) are immutable.
*
* @param validationGroupsMetadata The validation groups metadata for the validator.
* @return the bean descriptor for the class associated with this validator.
*
* @throws IllegalArgumentException if clazz is null
* @throws ValidationException if a non recoverable error happens during the
* metadata discovery or if some constraints are invalid.
*/
GwtBeanDescriptor getConstraints(ValidationGroupsMetadata validationGroupsMetadata)
throws ValidationException;
/**
* Validates all constraints on object.
*
* @param the type of the RootBean for this validation context
* @param context The gwt validation context
* @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(GwtValidationContext context,
G object, Class... groups) throws ValidationException;
/**
* Helper method used to perform validation of a bean using specific group(s). Does not expand
* the Default group seqeunce if it is redefined.
* @param context GWT validation context.
* @param object Object being validated.
* @param violations Set of violations to add to.
* @param groups What group(s) to validate.
*/
void validateClassGroups(
GwtValidationContext context,
G object,
Set> violations,
Class... groups);
/**
* Validates all constraints placed on the property of object
* named propertyName.
*
* @param the type of the RootBean for this validation context
* @param context The gwt validation context
* @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(
GwtValidationContext context, G object, String propertyName,
Class... groups) throws ValidationException;
/**
* Helper method used to perform validation of a bean property using specific group(s).
* @param context GWT validation context.
* @param object Object with property being validated.
* @param propertyName Name of property to validate.
* @param violations Set of violations to add to.
* @param groups What group(s) to validate.
*/
void validatePropertyGroups(
GwtValidationContext context,
G object,
String propertyName,
Set> violations,
Class... groups);
/**
* Validates all constraints placed on the property named
* propertyName of the class beanType where the
* property value is value.
*
* ConstraintViolation objects return null for
* {@link ConstraintViolation#getRootBean()} and
* {@link ConstraintViolation#getLeafBean()}
*
* @param the type of the RootBean for this validation context
* @param context The gwt validation context
* @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(
GwtValidationContext context, Class beanType, String propertyName,
Object value, Class... groups) throws ValidationException;
/**
* Helper method used to perform validation of a class property with a specified value
* using specific group(s).
* @param context GWT validation context.
* @param beanType Class with property being validated.
* @param propertyName Name of property to validate.
* @param value The value of the property to use.
* @param violations Set of violations to add to.
* @param groups What group(s) to validate.
*/
void validateValueGroups(
GwtValidationContext context,
Class beanType,
String propertyName,
Object value,
Set> violations,
Class... groups);
}