org.springmodules.validation.bean.conf.loader.xml
Class DefaultXmlBeanValidationConfigurationLoader

java.lang.Object
  org.springmodules.validation.bean.conf.loader.xml.AbstractResourceBasedBeanValidationConfigurationLoader
      org.springmodules.validation.bean.conf.loader.xml.AbstractXmlBeanValidationConfigurationLoader
          org.springmodules.validation.bean.conf.loader.xml.DefaultXmlBeanValidationConfigurationLoader

All Implemented Interfaces:

BeanValidationConfigurationLoader, ConditionExpressionBased

public class DefaultXmlBeanValidationConfigurationLoader
extends AbstractXmlBeanValidationConfigurationLoader
implements ConditionExpressionBased

The default xml bean validation configuration loader. This loader expects the following xml format:

 <validation [package="org.springmodules.validation.sample"]>
      <class name="Person">
          <global>
              <any/>...
          </global>
          <property name="firstName" [valid="true|false"]>
              <any/>...
          </property>
      </class>
 </validation>
 

Please note the following:

• Each <validation> element can contain multiple <class> elements.
• A <class> element can have only on <global> elements and multiple <property> elements. This elements hold validation rules to be bound globaly to the class instance or to specific properties.
• Both <global> and <property> elements can accept any element where each element represents a validation rule. These validation rule elements will eventually be evaluated in the order they are defined. When one of these rules fail, the evaluation stops
• A <property> may have a 'valid' attribute to indicate that the property value needs to be validated as well (cascade validation).
• The <validation> element may have a 'package' attribute. This will serve as a default package for all <class> elements (meaing there is not need to specify the fully qualified name in the 'name' attribute of this element.
• This XML format has a unique namespace which is defined by DEFAULT_NAMESPACE_URL.

The validation rule element (sub-elements of <global> and <property>) are resolved using validation rule element handlers. This class holds a registry for such handlers, where new handlers can be registered as well. The default registry is DefaultValidationRuleElementHandlerRegistry.

Author:

Uri Boness

Field Summary

static java.lang.String

DEFAULT_NAMESPACE_URL

Constructor Summary

DefaultXmlBeanValidationConfigurationLoader()
Constructs a new DefaultXmlBeanValidationConfigurationLoader with the default validation rule element handler registry.

DefaultXmlBeanValidationConfigurationLoader(ValidationRuleElementHandlerRegistry handlerRegistry)
Constructs a new DefaultXmlBeanValidationConfigurationLoader with the given validation rule element handler registry.

DefaultXmlBeanValidationConfigurationLoader(ValidationRuleElementHandlerRegistry handlerRegistry, ConditionExpressionParser conditionExpressionParser)
Constructs a new DefaultXmlBeanValidationConfigurationLoader with the given validation rule element handler registry.

Method Summary

void	afterPropertiesSet()
protected Validator	constructValidator(java.lang.String className)
protected PropertyValidationRule	createPropertyRule(java.lang.String propertyName, ValidationRule rule)
protected void	findConditionExpressionParserInApplicationContext()
ValidationRuleElementHandlerRegistry	getElementHandlerRegistry() Returns the element handler registry used by this loader.
BeanValidationConfiguration	handleClassDefinition(java.lang.Class clazz, org.w3c.dom.Element element) Creates and builds a bean validation configuration based for the given class, based on the given <class> element.
protected void	handleGlobalDefinition(org.w3c.dom.Element globalDefinition, java.lang.Class clazz, MutableBeanValidationConfiguration configuration) Handles the <global> element and updates the given configuration with the global validation rules.
protected void	handlePropertyDefinition(org.w3c.dom.Element propertyDefinition, java.lang.Class clazz, MutableBeanValidationConfiguration configuration) Handles the given <property> element and updates the given bean validation configuration with the property validation rules.
protected void	handleValidatorDefinition(org.w3c.dom.Element validatorDefinition, java.lang.Class clazz, MutableBeanValidationConfiguration configuration)
protected void	initContext(java.lang.Object object)
protected java.util.Map	loadConfigurations(org.w3c.dom.Document document, java.lang.String resourceName) Loads the validation configuration from the given document that was created from the given resource.
void	setApplicationContext(ApplicationContext applicationContext)
void	setConditionExpressionParser(ConditionExpressionParser conditionExpressionParser) Sets the condition expression parser to be used when parsing the condition expression.
void	setElementHandlerRegistry(ValidationRuleElementHandlerRegistry registry) Sets the element handler registry this loader will use to fetch the handlers while loading validation configuration.

Methods inherited from class org.springmodules.validation.bean.conf.loader.xml.AbstractXmlBeanValidationConfigurationLoader

loadConfigurations

Methods inherited from class org.springmodules.validation.bean.conf.loader.xml.AbstractResourceBasedBeanValidationConfigurationLoader

createDefaultConfigurationFileName, getResource, getResources, loadConfiguration, loadDefaultConfiguration, setResource, setResources, supports

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_NAMESPACE_URL

public static final java.lang.String DEFAULT_NAMESPACE_URL

See Also:

Constant Field Values

Constructor Detail

DefaultXmlBeanValidationConfigurationLoader

public DefaultXmlBeanValidationConfigurationLoader()

Constructs a new DefaultXmlBeanValidationConfigurationLoader with the default validation rule element handler registry.

DefaultXmlBeanValidationConfigurationLoader

public DefaultXmlBeanValidationConfigurationLoader(ValidationRuleElementHandlerRegistry handlerRegistry)

Constructs a new DefaultXmlBeanValidationConfigurationLoader with the given validation rule element handler registry.

Parameters:

handlerRegistry - The validation rule element handler registry that will be used by this loader.

DefaultXmlBeanValidationConfigurationLoader

public DefaultXmlBeanValidationConfigurationLoader(ValidationRuleElementHandlerRegistry handlerRegistry,
                                                   ConditionExpressionParser conditionExpressionParser)

Constructs a new DefaultXmlBeanValidationConfigurationLoader with the given validation rule element handler registry.

Parameters:

handlerRegistry - The validation rule element handler registry that will be used by this loader.

conditionExpressionParser - The condition parser this loader should use to parse the cascade validation conditions.

Method Detail

loadConfigurations

protected java.util.Map loadConfigurations(org.w3c.dom.Document document,
                                           java.lang.String resourceName)

Loads the validation configuration from the given document that was created from the given resource.

Specified by:

loadConfigurations in class AbstractXmlBeanValidationConfigurationLoader

See Also:

AbstractXmlBeanValidationConfigurationLoader.loadConfigurations(org.w3c.dom.Document, String)

afterPropertiesSet

public void afterPropertiesSet()
                        throws java.lang.Exception

Overrides:

afterPropertiesSet in class AbstractResourceBasedBeanValidationConfigurationLoader

Throws:

java.lang.Exception

See Also:

org.springframework.beans.factory.InitializingBean#afterPropertiesSet()

setElementHandlerRegistry

public void setElementHandlerRegistry(ValidationRuleElementHandlerRegistry registry)

Sets the element handler registry this loader will use to fetch the handlers while loading validation configuration.

Parameters:

registry - The element handler registry to be used by this loader.

getElementHandlerRegistry

public ValidationRuleElementHandlerRegistry getElementHandlerRegistry()

Returns the element handler registry used by this loader.

Returns:

The element handler registry used by this loader.

setConditionExpressionParser

public void setConditionExpressionParser(ConditionExpressionParser conditionExpressionParser)

Description copied from interface: ConditionExpressionBased

Sets the condition expression parser to be used when parsing the condition expression.

Specified by:

setConditionExpressionParser in interface ConditionExpressionBased

Parameters:

conditionExpressionParser - The condition expression parser to be used.

See Also:

ConditionExpressionBased.setConditionExpressionParser(org.springmodules.validation.util.cel.ConditionExpressionParser)

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)

See Also:

ApplicationContextAware#setApplicationContext(org.springframework.context.ApplicationContext)

initContext

protected void initContext(java.lang.Object object)
                    throws java.lang.Exception

Throws:

java.lang.Exception

handleClassDefinition

public BeanValidationConfiguration handleClassDefinition(java.lang.Class clazz,
                                                         org.w3c.dom.Element element)

Creates and builds a bean validation configuration based for the given class, based on the given <class> element.

Parameters:

element - The <class> element.

Returns:

The created bean validation configuration.

handleValidatorDefinition

protected void handleValidatorDefinition(org.w3c.dom.Element validatorDefinition,
                                         java.lang.Class clazz,
                                         MutableBeanValidationConfiguration configuration)

handleGlobalDefinition

protected void handleGlobalDefinition(org.w3c.dom.Element globalDefinition,
                                      java.lang.Class clazz,
                                      MutableBeanValidationConfiguration configuration)

Handles the <global> element and updates the given configuration with the global validation rules.

Parameters:

globalDefinition - The <global> element.

clazz - The validated class.

configuration - The bean validation configuration to update.

handlePropertyDefinition

protected void handlePropertyDefinition(org.w3c.dom.Element propertyDefinition,
                                        java.lang.Class clazz,
                                        MutableBeanValidationConfiguration configuration)

Handles the given <property> element and updates the given bean validation configuration with the property validation rules.

Parameters:

propertyDefinition - The <property> element.

clazz - The validated class.

configuration - The bean validation configuration to update.

createPropertyRule

protected PropertyValidationRule createPropertyRule(java.lang.String propertyName,
                                                    ValidationRule rule)

constructValidator

protected Validator constructValidator(java.lang.String className)

findConditionExpressionParserInApplicationContext

protected void findConditionExpressionParserInApplicationContext()