org.springframework.validation
Class DataBinder

java.lang.Object
  org.springframework.validation.DataBinder

Direct Known Subclasses:

ServletRequestDataBinder

public class DataBinder

extends java.lang.Object

Binder that allows for binding property values to a target object. The binding process can be customized through specifying allowed fields, required fields, and custom editors.

The binding results can be examined via the Errors interface, available as BindException instance. Missing field errors and property access exceptions will be converted to FieldErrors, collected in the Errors instance. Custom validation errors can be added afterwards.

This generic data binder can be used in any sort of environment. It is heavily used by Spring's web binding features, via the subclass ServletRequestDataBinder.

Version:

$Id: DataBinder.java,v 1.11 2004/03/18 02:46:00 trisberg Exp $

Author:

Rod Johnson, Juergen Hoeller

See Also:

bind(org.springframework.beans.PropertyValues), getErrors(), ServletRequestDataBinder

Field Summary

static java.lang.String

MISSING_FIELD_ERROR_CODE

Constructor Summary

DataBinder(java.lang.Object target, java.lang.String objectName)
Create a new DataBinder instance.

Method Summary

void	bind(PropertyValues pvs) Bind the given property values to this binder's target.
java.util.Map	close() Close this DataBinder, which may result in throwing a BindException if it encountered any errors
protected BindException	createErrors(java.lang.Object target, java.lang.String objectName) Create a new Errors instance for this data binder.
java.lang.String[]	getAllowedFields() Return the fields that should be allowed for binding.
BindException	getErrors() Return the Errors instance for this data binder.
java.lang.String	getObjectName() Return the name of the bound object.
java.lang.String[]	getRequiredFields() Return the fields that are required for each binding process.
java.lang.Object	getTarget() Return the wrapped target object.
protected boolean	isAllowed(java.lang.String field) Return if the given field is allowed for binding.
void	registerCustomEditor(java.lang.Class requiredType, java.beans.PropertyEditor propertyEditor) Register the given custom property editor for all properties of the given type.
void	registerCustomEditor(java.lang.Class requiredType, java.lang.String field, java.beans.PropertyEditor propertyEditor) Register the given custom property editor for the given type and field, or for all fields of the given type.
void	setAllowedFields(java.lang.String[] allowedFields) Register fields that should be allowed for binding.
void	setRequiredFields(java.lang.String[] requiredFields) Register fields that are required for each binding process.

Methods inherited from class java.lang.Object

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

Field Detail

MISSING_FIELD_ERROR_CODE

public static final java.lang.String MISSING_FIELD_ERROR_CODE

See Also:

Constant Field Values

Constructor Detail

DataBinder

public DataBinder(java.lang.Object target,
                  java.lang.String objectName)

Create a new DataBinder instance.

Parameters:

target - target object to bind onto

objectName - name of the target object

Method Detail

createErrors

protected BindException createErrors(java.lang.Object target,
                                     java.lang.String objectName)

Create a new Errors instance for this data binder. Can be overridden in subclasses to. Needs to be a subclass of BindException.

Parameters:

target - target object to bind onto

objectName - name of the target object

Returns:

the Errors instance

See Also:

close()

getTarget

public java.lang.Object getTarget()

Return the wrapped target object.

getObjectName

public java.lang.String getObjectName()

Return the name of the bound object.

getErrors

public BindException getErrors()

Return the Errors instance for this data binder.

Returns:

the Errors instance, to be treated as Errors or as BindException

See Also:

Errors

setAllowedFields

public void setAllowedFields(java.lang.String[] allowedFields)

Register fields that should be allowed for binding. Default is all fields. Restrict this for example to avoid unwanted modifications by malicious users when binding HTTP request parameters.

Parameters:

allowedFields - array of field names

See Also:

ServletRequestDataBinder

getAllowedFields

public java.lang.String[] getAllowedFields()

Return the fields that should be allowed for binding.

Returns:

array of field names

setRequiredFields

public void setRequiredFields(java.lang.String[] requiredFields)

Register fields that are required for each binding process.

Parameters:

requiredFields - array of field names

getRequiredFields

public java.lang.String[] getRequiredFields()

Return the fields that are required for each binding process.

Returns:

array of field names

registerCustomEditor

public void registerCustomEditor(java.lang.Class requiredType,
                                 java.beans.PropertyEditor propertyEditor)

Register the given custom property editor for all properties of the given type.

Parameters:

requiredType - type of the property

propertyEditor - editor to register

registerCustomEditor

public void registerCustomEditor(java.lang.Class requiredType,
                                 java.lang.String field,
                                 java.beans.PropertyEditor propertyEditor)

Register the given custom property editor for the given type and field, or for all fields of the given type.

Parameters:

requiredType - type of the property, can be null if a field is given but should be specified in any case for consistency checking

field - name of the field (can also be a nested path), or null if registering an editor for all fields of the given type

propertyEditor - editor to register

bind

public void bind(PropertyValues pvs)

Bind the given property values to this binder's target. This call can create field errors, representing basic binding errors like a required field (code "required"), or type mismatch between value and bean property (code "typeMismatch").

Note that the given PropertyValues should be a throwaway instance: For efficiency, it will be modified to just contain allowed fields if it implements the MutablePropertyValues interface; else, an internal mutable copy will be created for this purpose. Pass in a copy of the PropertyValues if you want your original instance to stay unmodified in any case.

Parameters:

pvs - property values to bind.

isAllowed

protected boolean isAllowed(java.lang.String field)

Return if the given field is allowed for binding. Invoked for each passed-in property value.

The default implementation checks for "xxx*" and "*xxx" matches. Can be overridden in subclasses.

If the field is found in the allowedFields array as direct match, this method will not be invoked.

Parameters:

field - the field to check

Returns:

if the field is allowed

See Also:

setAllowedFields(java.lang.String[])

close

public java.util.Map close()
                    throws BindException

Close this DataBinder, which may result in throwing a BindException if it encountered any errors

Returns:

the model Map, containing target object and Errors instance

Throws:

BindException - if there were any errors in the bind operation

See Also:

BindException.getModel()