站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Spring Framework 1.2.9 API 文档英文版

PropertyAccessor (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

org.springframework.beans
Interface PropertyAccessor

All Known Subinterfaces:
BeanWrapper
All Known Implementing Classes:
BeanWrapperImpl
public interface PropertyAccessor

Common interface for classes that can access bean properties. Serves as base interface for BeanWrapper.

Since:
1.1
Author:
Juergen Hoeller
See Also:
BeanWrapper

Field Summary
static String NESTED_PROPERTY_SEPARATOR
          Path separator for nested properties.
static char NESTED_PROPERTY_SEPARATOR_CHAR
           
static String PROPERTY_KEY_PREFIX
          Marker that indicates the start of a property key for an indexed or mapped property like "person.addresses[0]".
static char PROPERTY_KEY_PREFIX_CHAR
           
static String PROPERTY_KEY_SUFFIX
          Marker that indicates the end of a property key for an indexed or mapped property like "person.addresses[0]".
static char PROPERTY_KEY_SUFFIX_CHAR
           
 
Method Summary
 Object getPropertyValue(String propertyName)
          Get the current value of the specified property.
 void setPropertyValue(PropertyValue pv)
          Set the specified value as current property value.
 void setPropertyValue(String propertyName, Object value)
          Set the specified value as current property value.
 void setPropertyValues(Map map)
          Perform a batch update from a Map.
 void setPropertyValues(PropertyValues pvs)
          The preferred way to perform a batch update.
 void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown)
          Perform a batch update with full control over behavior.
 

Field Detail

NESTED_PROPERTY_SEPARATOR

static final String NESTED_PROPERTY_SEPARATOR
Path separator for nested properties. Follows normal Java conventions: getFoo().getBar() would be "foo.bar".

See Also:
Constant Field Values

NESTED_PROPERTY_SEPARATOR_CHAR

static final char NESTED_PROPERTY_SEPARATOR_CHAR
See Also:
Constant Field Values

PROPERTY_KEY_PREFIX

static final String PROPERTY_KEY_PREFIX
Marker that indicates the start of a property key for an indexed or mapped property like "person.addresses[0]".

See Also:
Constant Field Values

PROPERTY_KEY_PREFIX_CHAR

static final char PROPERTY_KEY_PREFIX_CHAR
See Also:
Constant Field Values

PROPERTY_KEY_SUFFIX

static final String PROPERTY_KEY_SUFFIX
Marker that indicates the end of a property key for an indexed or mapped property like "person.addresses[0]".

See Also:
Constant Field Values

PROPERTY_KEY_SUFFIX_CHAR

static final char PROPERTY_KEY_SUFFIX_CHAR
See Also:
Constant Field Values
Method Detail

getPropertyValue

Object getPropertyValue(String propertyName)
                        throws BeansException
Get the current value of the specified property.

Parameters:
propertyName - the name of the property to get the value of (may be a nested path and/or an indexed/mapped property)
Returns:
the value of the property
Throws:
InvalidPropertyException - if there is no such property or if the property isn't readable
PropertyAccessException - if the property was valid but the accessor method failed
BeansException

setPropertyValue

void setPropertyValue(String propertyName,
                      Object value)
                      throws BeansException
Set the specified value as current property value.

Parameters:
propertyName - the name of the property to set the value of (may be a nested path and/or an indexed/mapped property)
value - the new value
Throws:
InvalidPropertyException - if there is no such property or if the property isn't writable
PropertyAccessException - if the property was valid but the accessor method failed or a type mismatch occured
BeansException

setPropertyValue

void setPropertyValue(PropertyValue pv)
                      throws BeansException
Set the specified value as current property value.

Parameters:
pv - an object containing the new property value
Throws:
InvalidPropertyException - if there is no such property or if the property isn't writable
PropertyAccessException - if the property was valid but the accessor method failed or a type mismatch occured
BeansException

setPropertyValues

void setPropertyValues(Map map)
                       throws BeansException
Perform a batch update from a Map.

Bulk updates from PropertyValues are more powerful: This method is provided for convenience. Behavior will be identical to that of the setPropertyValues(PropertyValues) method.

Parameters:
map - Map to take properties from. Contains property value objects, keyed by property name
Throws:
InvalidPropertyException - if there is no such property or if the property isn't writable
PropertyAccessExceptionsException - if one or more PropertyAccessExceptions occured for specific properties during the batch update. This exception bundles all individual PropertyAccessExceptions. All other properties will have been successfully updated.
BeansException

setPropertyValues

void setPropertyValues(PropertyValues pvs)
                       throws BeansException
The preferred way to perform a batch update.

Note that performing a batch update differs from performing a single update, in that an implementation of this class will continue to update properties if a recoverable error (such as a type mismatch, but not an invalid field name or the like) is encountered, throwing a PropertyAccessExceptionsException containing all the individual errors. This exception can be examined later to see all binding errors. Properties that were successfully updated remain changed.

Does not allow unknown fields or invalid fields.

Parameters:
pvs - PropertyValues to set on the target object
Throws:
InvalidPropertyException - if there is no such property or if the property isn't writable
PropertyAccessExceptionsException - if one or more PropertyAccessExceptions occured for specific properties during the batch update. This exception bundles all individual PropertyAccessExceptions. All other properties will have been successfully updated.
BeansException
See Also:
setPropertyValues(PropertyValues, boolean)

setPropertyValues

void setPropertyValues(PropertyValues pvs,
                       boolean ignoreUnknown)
                       throws BeansException
Perform a batch update with full control over behavior.

Note that performing a batch update differs from performing a single update, in that an implementation of this class will continue to update properties if a recoverable error (such as a type mismatch, but not an invalid field name or the like) is encountered, throwing a PropertyAccessExceptionsException containing all the individual errors. This exception can be examined later to see all binding errors. Properties that were successfully updated remain changed.

Parameters:
pvs - PropertyValues to set on the target object
ignoreUnknown - should we ignore unknown properties (not found in the bean)
Throws:
InvalidPropertyException - if there is no such property or if the property isn't writable
PropertyAccessExceptionsException - if one or more PropertyAccessExceptions occured for specific properties during the batch update. This exception bundles all individual PropertyAccessExceptions. All other properties will have been successfully updated.
BeansException
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Copyright (c) 2002-2007 The Spring Framework Project.