|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface BeanWrapper
The central interface of Spring's low-level JavaBeans infrastructure.
Typically not used directly but rather implicitly via a
BeanFactory
or a
DataBinder
.
Provides operations to analyze and manipulate standard JavaBeans: the ability to get and set property values (individually or in bulk), get property descriptors, and query the readability/writability of properties.
This interface supports nested properties enabling the setting
of properties on subproperties to an unlimited depth.
A BeanWrapper
instance can be used repeatedly, with its
target object
(the wrapped JavaBean
instance) changing as required.
A BeanWrapper's default for the "extractOldValueForEditor" setting is "false", to avoid side effects caused by getter method invocations. Turn this to "true" to expose present property values to custom editors.
ConfigurablePropertyAccessor.setExtractOldValueForEditor(boolean)
,
PropertyAccessor
,
PropertyEditorRegistry
,
BeanWrapperImpl
,
BeanFactory
,
BeanPropertyBindingResult
,
DataBinder.initBeanPropertyAccess()
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 |
Method Summary | |
---|---|
PropertyDescriptor |
getPropertyDescriptor(String propertyName)
Obtain the property descriptor for a specific property of the wrapped object. |
PropertyDescriptor[] |
getPropertyDescriptors()
Obtain the PropertyDescriptors for the wrapped object (as determined by standard JavaBeans introspection). |
Class |
getWrappedClass()
Return the type of the wrapped JavaBean object. |
Object |
getWrappedInstance()
Return the bean instance wrapped by this object, if any. |
void |
setWrappedInstance(Object obj)
Change the wrapped JavaBean object. |
Methods inherited from interface org.springframework.beans.ConfigurablePropertyAccessor |
---|
isExtractOldValueForEditor, setExtractOldValueForEditor |
Methods inherited from interface org.springframework.beans.PropertyAccessor |
---|
getPropertyType, getPropertyValue, isReadableProperty, isWritableProperty, setPropertyValue, setPropertyValue, setPropertyValues, setPropertyValues, setPropertyValues, setPropertyValues |
Methods inherited from interface org.springframework.beans.PropertyEditorRegistry |
---|
findCustomEditor, registerCustomEditor, registerCustomEditor |
Methods inherited from interface org.springframework.beans.TypeConverter |
---|
convertIfNecessary, convertIfNecessary |
Method Detail |
---|
void setWrappedInstance(Object obj)
obj
- the bean instance to wrapObject getWrappedInstance()
null
if none setClass getWrappedClass()
null
if no wrapped object has been setPropertyDescriptor[] getPropertyDescriptors()
PropertyDescriptor getPropertyDescriptor(String propertyName) throws BeansException
propertyName
- the property to obtain the descriptor for
(may be a nested path, but no indexed/mapped property)
InvalidPropertyException
- if there is no such property
BeansException
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |