org.codehaus.groovy.grails.web.binding
Class GrailsDataBinder

java.lang.Object
  org.springframework.validation.DataBinder
      org.springframework.web.bind.WebDataBinder
          org.springframework.web.bind.ServletRequestDataBinder
              org.codehaus.groovy.grails.web.binding.GrailsDataBinder

All Implemented Interfaces:

PropertyEditorRegistry, TypeConverter

public class GrailsDataBinder
extends ServletRequestDataBinder

A data binder that handles binding dates that are specified with a "struct"-like syntax in request parameters. For example for a set of fields defined as:

This would set the property "myDate" of type java.util.Date with the specified values.

Since:

05-Jan-2006

Author:

Graeme Rocher

Field Summary

protected BeanWrapper	bean
static String	DEFAULT_DATE_FORMAT
static String[]	DOMAINCLASS_DISALLOWED
static String[]	GROOVY_DISALLOWED
static String[]	GROOVY_DOMAINCLASS_DISALLOWED
static String	NULL_ASSOCIATION

Fields inherited from class org.springframework.web.bind.WebDataBinder

DEFAULT_FIELD_DEFAULT_PREFIX, DEFAULT_FIELD_MARKER_PREFIX

Fields inherited from class org.springframework.validation.DataBinder

DEFAULT_OBJECT_NAME, logger

Constructor Summary

GrailsDataBinder(Object target, String objectName)
Create a new GrailsDataBinder instance.

Method Summary

protected void	autoCreateIfPossible(MutablePropertyValues mpvs) Method that auto-creates the a type if it is null and is possible to auto-create
void	bind(org.codehaus.groovy.grails.web.servlet.mvc.GrailsParameterMap params) Binds from a GrailsParameterMap object
void	bind(org.codehaus.groovy.grails.web.servlet.mvc.GrailsParameterMap params, String prefix)
void	bind(PropertyValues propertyValues)
void	bind(PropertyValues propertyValues, String prefix)
void	bind(ServletRequest request)
void	bind(ServletRequest request, String prefix)
protected void	bindAssociations(MutablePropertyValues mpvs) Interrogates the specified properties looking for properites that represent associations to other classes (e.g., 'author.id').
static GrailsDataBinder	createBinder(Object target, String objectName) Utility method for creating a GrailsDataBinder instance
static GrailsDataBinder	createBinder(Object target, String objectName, HttpServletRequest request) Utility method for creating a GrailsDataBinder instance
protected void	doBind(MutablePropertyValues mpvs)
static void	registerCustomEditors(PropertyEditorRegistry registry, Locale locale) Registers all known

Methods inherited from class org.springframework.web.bind.ServletRequestDataBinder

closeNoCatch

Methods inherited from class org.springframework.web.bind.WebDataBinder

bindMultipartFiles, checkFieldDefaults, checkFieldMarkers, getEmptyValue, getFieldDefaultPrefix, getFieldMarkerPrefix, isBindEmptyMultipartFiles, setBindEmptyMultipartFiles, setFieldDefaultPrefix, setFieldMarkerPrefix

Methods inherited from class org.springframework.validation.DataBinder

applyPropertyValues, checkAllowedFields, checkRequiredFields, close, convertIfNecessary, convertIfNecessary, findCustomEditor, getAllowedFields, getBindingErrorProcessor, getBindingResult, getConversionService, getDisallowedFields, getErrors, getInternalBindingResult, getObjectName, getPropertyAccessor, getPropertyEditorRegistry, getRequiredFields, getSimpleTypeConverter, getTarget, getTypeConverter, getValidator, initBeanPropertyAccess, initDirectFieldAccess, isAllowed, isAutoGrowNestedPaths, isIgnoreInvalidFields, isIgnoreUnknownFields, registerCustomEditor, registerCustomEditor, setAllowedFields, setAutoGrowNestedPaths, setBindingErrorProcessor, setConversionService, setDisallowedFields, setExtractOldValueForEditor, setIgnoreInvalidFields, setIgnoreUnknownFields, setMessageCodesResolver, setRequiredFields, setValidator, validate

Methods inherited from class java.lang.Object

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

Field Detail

bean

protected BeanWrapper bean

GROOVY_DISALLOWED

public static final String[] GROOVY_DISALLOWED

DOMAINCLASS_DISALLOWED

public static final String[] DOMAINCLASS_DISALLOWED

GROOVY_DOMAINCLASS_DISALLOWED

public static final String[] GROOVY_DOMAINCLASS_DISALLOWED

NULL_ASSOCIATION

public static final String NULL_ASSOCIATION

See Also:

Constant Field Values

DEFAULT_DATE_FORMAT

public static final String DEFAULT_DATE_FORMAT

See Also:

Constant Field Values

Constructor Detail

GrailsDataBinder

public GrailsDataBinder(Object target,
                        String objectName)

Create a new GrailsDataBinder instance.

Parameters:

target - target object to bind onto

objectName - objectName of the target object

Method Detail

createBinder

public static GrailsDataBinder createBinder(Object target,
                                            String objectName,
                                            HttpServletRequest request)

Utility method for creating a GrailsDataBinder instance

Parameters:

target - The target object to bind to

objectName - The name of the object

request - A request instance

Returns:

A GrailsDataBinder instance

registerCustomEditors

public static void registerCustomEditors(PropertyEditorRegistry registry,
                                         Locale locale)

Registers all known

Parameters:

registry -

locale -

createBinder

public static GrailsDataBinder createBinder(Object target,
                                            String objectName)

Utility method for creating a GrailsDataBinder instance

Parameters:

target - The target object to bind to

objectName - The name of the object

Returns:

A GrailsDataBinder instance

bind

public void bind(PropertyValues propertyValues)

Overrides:

bind in class DataBinder

bind

public void bind(org.codehaus.groovy.grails.web.servlet.mvc.GrailsParameterMap params)

Binds from a GrailsParameterMap object

Parameters:

params - The GrailsParameterMap object

bind

public void bind(org.codehaus.groovy.grails.web.servlet.mvc.GrailsParameterMap params,
                 String prefix)

bind

public void bind(PropertyValues propertyValues,
                 String prefix)

bind

public void bind(ServletRequest request)

Overrides:

bind in class ServletRequestDataBinder

bind

public void bind(ServletRequest request,
                 String prefix)

doBind

protected void doBind(MutablePropertyValues mpvs)

Overrides:

doBind in class WebDataBinder

autoCreateIfPossible

protected void autoCreateIfPossible(MutablePropertyValues mpvs)

Method that auto-creates the a type if it is null and is possible to auto-create

Parameters:

mpvs - A MutablePropertyValues instance

bindAssociations

protected void bindAssociations(MutablePropertyValues mpvs)

Interrogates the specified properties looking for properites that represent associations to other classes (e.g., 'author.id'). If such a property is found, this method attempts to load the specified instance of the association (by ID) and set it on the target object.

Parameters:

mpvs - the MutablePropertyValues object holding the parameters from the request