|
||||||||||
| 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,
PropertyAccessorFactory.forBeanPropertyAccess(java.lang.Object),
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)
Deprecated. as of Spring 2.5, in favor of recreating a BeanWrapper per target instance |
| 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
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||