public interface PropertyAccessor
BeanWrapper.BeanWrapper, 
PropertyAccessorFactory.forBeanPropertyAccess(java.lang.Object), 
PropertyAccessorFactory.forDirectFieldAccess(java.lang.Object)| Modifier and Type | Field and Description | 
|---|---|
| static String | NESTED_PROPERTY_SEPARATORPath separator for nested properties. | 
| static char | NESTED_PROPERTY_SEPARATOR_CHARPath separator for nested properties. | 
| static String | PROPERTY_KEY_PREFIXMarker that indicates the start of a property key for an
 indexed or mapped property like "person.addresses[0]". | 
| static char | PROPERTY_KEY_PREFIX_CHARMarker that indicates the start of a property key for an
 indexed or mapped property like "person.addresses[0]". | 
| static String | PROPERTY_KEY_SUFFIXMarker that indicates the end of a property key for an
 indexed or mapped property like "person.addresses[0]". | 
| static char | PROPERTY_KEY_SUFFIX_CHARMarker that indicates the end of a property key for an
 indexed or mapped property like "person.addresses[0]". | 
| Modifier and Type | Method and Description | 
|---|---|
| Class<?> | getPropertyType(String propertyName)Determine the property type for the specified property,
 either checking the property descriptor or checking the value
 in case of an indexed or mapped element. | 
| org.springframework.core.convert.TypeDescriptor | getPropertyTypeDescriptor(String propertyName)Return a type descriptor for the specified property:
 preferably from the read method, falling back to the write method. | 
| Object | getPropertyValue(String propertyName)Get the current value of the specified property. | 
| boolean | isReadableProperty(String propertyName)Determine whether the specified property is readable. | 
| boolean | isWritableProperty(String propertyName)Determine whether the specified property is writable. | 
| 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 more control over behavior. | 
| void | setPropertyValues(PropertyValues pvs,
                 boolean ignoreUnknown,
                 boolean ignoreInvalid)Perform a batch update with full control over behavior. | 
static final String NESTED_PROPERTY_SEPARATOR
static final char NESTED_PROPERTY_SEPARATOR_CHAR
static final String PROPERTY_KEY_PREFIX
static final char PROPERTY_KEY_PREFIX_CHAR
static final String PROPERTY_KEY_SUFFIX
static final char PROPERTY_KEY_SUFFIX_CHAR
boolean isReadableProperty(String propertyName)
Returns false if the property doesn't exist.
propertyName - the property to check
 (may be a nested path and/or an indexed/mapped property)boolean isWritableProperty(String propertyName)
Returns false if the property doesn't exist.
propertyName - the property to check
 (may be a nested path and/or an indexed/mapped property)@Nullable Class<?> getPropertyType(String propertyName) throws BeansException
propertyName - the property to check
 (may be a nested path and/or an indexed/mapped property)null if not determinablePropertyAccessException - if the property was valid but the
 accessor method failedBeansException@Nullable org.springframework.core.convert.TypeDescriptor getPropertyTypeDescriptor(String propertyName) throws BeansException
propertyName - the property to check
 (may be a nested path and/or an indexed/mapped property)null if not determinablePropertyAccessException - if the property was valid but the
 accessor method failedBeansException@Nullable Object getPropertyValue(String propertyName) throws BeansException
propertyName - the name of the property to get the value of
 (may be a nested path and/or an indexed/mapped property)InvalidPropertyException - if there is no such property or
 if the property isn't readablePropertyAccessException - if the property was valid but the
 accessor method failedBeansExceptionvoid setPropertyValue(String propertyName, @Nullable Object value) throws BeansException
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 valueInvalidPropertyException - if there is no such property or
 if the property isn't writablePropertyAccessException - if the property was valid but the
 accessor method failed or a type mismatch occurredBeansExceptionvoid setPropertyValue(PropertyValue pv) throws BeansException
pv - an object containing the new property valueInvalidPropertyException - if there is no such property or
 if the property isn't writablePropertyAccessException - if the property was valid but the
 accessor method failed or a type mismatch occurredBeansExceptionvoid setPropertyValues(Map<?,?> map) throws BeansException
Bulk updates from PropertyValues are more powerful: This method is
 provided for convenience. Behavior will be identical to that of
 the setPropertyValues(PropertyValues) method.
map - a Map to take properties from. Contains property value objects,
 keyed by property nameInvalidPropertyException - if there is no such property or
 if the property isn't writablePropertyBatchUpdateException - if one or more PropertyAccessExceptions
 occurred for specific properties during the batch update. This exception bundles
 all individual PropertyAccessExceptions. All other properties will have been
 successfully updated.BeansExceptionvoid setPropertyValues(PropertyValues pvs) throws BeansException
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
 PropertyBatchUpdateException 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.
pvs - a PropertyValues to set on the target objectInvalidPropertyException - if there is no such property or
 if the property isn't writablePropertyBatchUpdateException - if one or more PropertyAccessExceptions
 occurred for specific properties during the batch update. This exception bundles
 all individual PropertyAccessExceptions. All other properties will have been
 successfully updated.BeansExceptionsetPropertyValues(PropertyValues, boolean, boolean)void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown) throws BeansException
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
 PropertyBatchUpdateException containing all the individual errors.
 This exception can be examined later to see all binding errors.
 Properties that were successfully updated remain changed.
pvs - a PropertyValues to set on the target objectignoreUnknown - should we ignore unknown properties (not found in the bean)InvalidPropertyException - if there is no such property or
 if the property isn't writablePropertyBatchUpdateException - if one or more PropertyAccessExceptions
 occurred for specific properties during the batch update. This exception bundles
 all individual PropertyAccessExceptions. All other properties will have been
 successfully updated.BeansExceptionsetPropertyValues(PropertyValues, boolean, boolean)void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown, boolean ignoreInvalid) throws BeansException
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
 PropertyBatchUpdateException containing all the individual errors.
 This exception can be examined later to see all binding errors.
 Properties that were successfully updated remain changed.
pvs - a PropertyValues to set on the target objectignoreUnknown - should we ignore unknown properties (not found in the bean)ignoreInvalid - should we ignore invalid properties (found but not accessible)InvalidPropertyException - if there is no such property or
 if the property isn't writablePropertyBatchUpdateException - if one or more PropertyAccessExceptions
 occurred for specific properties during the batch update. This exception bundles
 all individual PropertyAccessExceptions. All other properties will have been
 successfully updated.BeansException