org.springframework.beans

Class DirectFieldAccessor

java.lang.Object

org.springframework.beans.PropertyEditorRegistrySupport

org.springframework.beans.TypeConverterSupport

org.springframework.beans.AbstractPropertyAccessor

org.springframework.beans.AbstractNestablePropertyAccessor

org.springframework.beans.DirectFieldAccessor

All Implemented Interfaces:

ConfigurablePropertyAccessor, PropertyAccessor, PropertyEditorRegistry, TypeConverter

public class DirectFieldAccessor
extends AbstractNestablePropertyAccessor

ConfigurablePropertyAccessor implementation that directly accesses instance fields. Allows for direct binding to fields instead of going through JavaBean setters.

As of Spring 4.2, the vast majority of the BeanWrapper features have been merged to AbstractPropertyAccessor, which means that property traversal as well as collections and map access is now supported here as well.

A DirectFieldAccessor's default for the "extractOldValueForEditor" setting is "true", since a field can always be read without side effects.

Since:

2.0

Author:

Juergen Hoeller, Stephane Nicoll

See Also:

AbstractPropertyAccessor.setExtractOldValueForEditor(boolean), BeanWrapper, DirectFieldBindingResult, DataBinder.initDirectFieldAccess()

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.beans.AbstractNestablePropertyAccessor

AbstractNestablePropertyAccessor.PropertyHandler, AbstractNestablePropertyAccessor.PropertyTokenHolder

Field Summary

Fields inherited from interface org.springframework.beans.PropertyAccessor

NESTED_PROPERTY_SEPARATOR, NESTED_PROPERTY_SEPARATOR_CHAR, PROPERTY_KEY_PREFIX, PROPERTY_KEY_PREFIX_CHAR, PROPERTY_KEY_SUFFIX, PROPERTY_KEY_SUFFIX_CHAR

Constructor Summary

Constructors

Modifier	Constructor and Description
	DirectFieldAccessor(Object object)
protected	DirectFieldAccessor(Object object, String nestedPath, DirectFieldAccessor superBw)

Method Summary

Modifier and Type	Method and Description
protected NotWritablePropertyException	createNotWritablePropertyException(String propertyName) Create a NotWritablePropertyException for the specified property.
protected org.springframework.beans.DirectFieldAccessor.FieldPropertyHandler	getLocalPropertyHandler(String propertyName) Return a AbstractNestablePropertyAccessor.PropertyHandler for the specified local propertyName.
protected DirectFieldAccessor	newNestedPropertyAccessor(Object object, String nestedPath) Create a new nested property accessor instance.

Methods inherited from class org.springframework.beans.AbstractNestablePropertyAccessor

convertForProperty, getAutoGrowCollectionLimit, getNestedPath, getPropertyAccessorForPropertyPath, getPropertyHandler, getPropertyType, getPropertyTypeDescriptor, getPropertyValue, getPropertyValue, getRootClass, getRootInstance, getWrappedClass, getWrappedInstance, isReadableProperty, isWritableProperty, setAutoGrowCollectionLimit, setPropertyValue, setPropertyValue, setPropertyValue, setWrappedInstance, setWrappedInstance, toString

Methods inherited from class org.springframework.beans.AbstractPropertyAccessor

isAutoGrowNestedPaths, isExtractOldValueForEditor, setAutoGrowNestedPaths, setExtractOldValueForEditor, setPropertyValues, setPropertyValues, setPropertyValues, setPropertyValues

Methods inherited from class org.springframework.beans.TypeConverterSupport

convertIfNecessary, convertIfNecessary, convertIfNecessary

Methods inherited from class org.springframework.beans.PropertyEditorRegistrySupport

copyCustomEditorsTo, copyDefaultEditorsTo, findCustomEditor, getConversionService, getDefaultEditor, guessPropertyTypeFromEditors, hasCustomEditorForElement, overrideDefaultEditor, registerCustomEditor, registerCustomEditor, registerDefaultEditors, setConversionService, useConfigValueEditors

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.beans.ConfigurablePropertyAccessor

getConversionService, setConversionService

Methods inherited from interface org.springframework.beans.PropertyEditorRegistry

findCustomEditor, registerCustomEditor, registerCustomEditor

Methods inherited from interface org.springframework.beans.TypeConverter

convertIfNecessary, convertIfNecessary, convertIfNecessary

Constructor Detail

DirectFieldAccessor

public DirectFieldAccessor(Object object)

DirectFieldAccessor

protected DirectFieldAccessor(Object object,
                              String nestedPath,
                              DirectFieldAccessor superBw)

Method Detail

getLocalPropertyHandler

protected org.springframework.beans.DirectFieldAccessor.FieldPropertyHandler getLocalPropertyHandler(String propertyName)

Description copied from class: AbstractNestablePropertyAccessor

Return a AbstractNestablePropertyAccessor.PropertyHandler for the specified local propertyName. Only used to reach a property available in the current context.

Specified by:

getLocalPropertyHandler in class AbstractNestablePropertyAccessor

Parameters:

propertyName - the name of a local property

Returns:

the handler for that property or null if it has not been found

newNestedPropertyAccessor

protected DirectFieldAccessor newNestedPropertyAccessor(Object object,
                                                        String nestedPath)

Description copied from class: AbstractNestablePropertyAccessor

Create a new nested property accessor instance. Can be overridden in subclasses to create a PropertyAccessor subclass.

Specified by:

newNestedPropertyAccessor in class AbstractNestablePropertyAccessor

Parameters:

object - object wrapped by this PropertyAccessor

nestedPath - the nested path of the object

Returns:

the nested PropertyAccessor instance

createNotWritablePropertyException

protected NotWritablePropertyException createNotWritablePropertyException(String propertyName)

Description copied from class: AbstractNestablePropertyAccessor

Create a NotWritablePropertyException for the specified property.

Specified by:

createNotWritablePropertyException in class AbstractNestablePropertyAccessor