org.springframework.beans

类 AbstractPropertyAccessor

java.lang.Object

org.springframework.beans.PropertyEditorRegistrySupport

org.springframework.beans.TypeConverterSupport

org.springframework.beans.AbstractPropertyAccessor

所有已实现的接口:

ConfigurablePropertyAccessor, PropertyAccessor, PropertyEditorRegistry, TypeConverter

直接已知子类:

AbstractNestablePropertyAccessor

public abstract class AbstractPropertyAccessor
extends TypeConverterSupport
implements ConfigurablePropertyAccessor

Abstract implementation of the PropertyAccessor interface. Provides base implementations of all convenience methods, with the implementation of actual property access left to subclasses.

从以下版本开始:

2.0

作者:

Juergen Hoeller, Stephane Nicoll

另请参阅:

getPropertyValue(java.lang.String), setPropertyValue(org.springframework.beans.PropertyValue)

字段概要

从接口继承的字段 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

构造器概要

构造器

构造器和说明
AbstractPropertyAccessor()

方法概要

限定符和类型	方法和说明
Class<?>	getPropertyType(String propertyPath) Determine the property type for the given property path.
abstract Object	getPropertyValue(String propertyName) Actually get the value of a property.
boolean	isAutoGrowNestedPaths() Return whether "auto-growing" of nested paths has been activated.
boolean	isExtractOldValueForEditor() Return whether to extract the old property value when applying a property editor to a new value for a property.
void	setAutoGrowNestedPaths(boolean autoGrowNestedPaths) Set whether this instance should attempt to "auto-grow" a nested path that contains a null value.
void	setExtractOldValueForEditor(boolean extractOldValueForEditor) Set whether to extract the old property value when applying a property editor to a new value for a property.
void	setPropertyValue(PropertyValue pv) Set the specified value as current property value.
abstract void	setPropertyValue(String propertyName, Object value) Actually set a 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.

从类继承的方法 org.springframework.beans.TypeConverterSupport

convertIfNecessary, convertIfNecessary, convertIfNecessary

从类继承的方法 org.springframework.beans.PropertyEditorRegistrySupport

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

从类继承的方法 java.lang.Object

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

从接口继承的方法 org.springframework.beans.ConfigurablePropertyAccessor

getConversionService, setConversionService

从接口继承的方法 org.springframework.beans.PropertyAccessor

getPropertyTypeDescriptor, isReadableProperty, isWritableProperty

从接口继承的方法 org.springframework.beans.PropertyEditorRegistry

findCustomEditor, registerCustomEditor, registerCustomEditor

从接口继承的方法 org.springframework.beans.TypeConverter

convertIfNecessary, convertIfNecessary, convertIfNecessary

构造器详细资料

AbstractPropertyAccessor

public AbstractPropertyAccessor()

方法详细资料

setExtractOldValueForEditor

public void setExtractOldValueForEditor(boolean extractOldValueForEditor)

从接口复制的说明: ConfigurablePropertyAccessor

Set whether to extract the old property value when applying a property editor to a new value for a property.

指定者:

setExtractOldValueForEditor 在接口中 ConfigurablePropertyAccessor

isExtractOldValueForEditor

public boolean isExtractOldValueForEditor()

从接口复制的说明: ConfigurablePropertyAccessor

Return whether to extract the old property value when applying a property editor to a new value for a property.

指定者:

isExtractOldValueForEditor 在接口中 ConfigurablePropertyAccessor

setAutoGrowNestedPaths

public void setAutoGrowNestedPaths(boolean autoGrowNestedPaths)

从接口复制的说明: ConfigurablePropertyAccessor

Set whether this instance should attempt to "auto-grow" a nested path that contains a null value.

If true, a null path location will be populated with a default object value and traversed instead of resulting in a NullValueInNestedPathException.

Default is false on a plain PropertyAccessor instance.

指定者:

setAutoGrowNestedPaths 在接口中 ConfigurablePropertyAccessor

isAutoGrowNestedPaths

public boolean isAutoGrowNestedPaths()

从接口复制的说明: ConfigurablePropertyAccessor

Return whether "auto-growing" of nested paths has been activated.

指定者:

isAutoGrowNestedPaths 在接口中 ConfigurablePropertyAccessor

setPropertyValue

public void setPropertyValue(PropertyValue pv)
                      throws BeansException

从接口复制的说明: PropertyAccessor

Set the specified value as current property value.

指定者:

setPropertyValue 在接口中 PropertyAccessor

参数:

pv - an object containing the new property value

抛出:

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 occurred

BeansException

setPropertyValues

public void setPropertyValues(Map<?,?> map)
                       throws BeansException

从接口复制的说明: PropertyAccessor

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 PropertyAccessor.setPropertyValues(PropertyValues) method.

指定者:

setPropertyValues 在接口中 PropertyAccessor

参数:

map - Map to take properties from. Contains property value objects, keyed by property name

抛出:

InvalidPropertyException - if there is no such property or if the property isn't writable

PropertyBatchUpdateException - 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

setPropertyValues

public void setPropertyValues(PropertyValues pvs)
                       throws BeansException

从接口复制的说明: PropertyAccessor

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 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.

指定者:

setPropertyValues 在接口中 PropertyAccessor

参数:

pvs - PropertyValues to set on the target object

抛出:

InvalidPropertyException - if there is no such property or if the property isn't writable

PropertyBatchUpdateException - 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

另请参阅:

PropertyAccessor.setPropertyValues(PropertyValues, boolean, boolean)

setPropertyValues

public void setPropertyValues(PropertyValues pvs,
                              boolean ignoreUnknown)
                       throws BeansException

从接口复制的说明: PropertyAccessor

Perform a batch update with more 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 PropertyBatchUpdateException containing all the individual errors. This exception can be examined later to see all binding errors. Properties that were successfully updated remain changed.

指定者:

setPropertyValues 在接口中 PropertyAccessor

参数:

pvs - PropertyValues to set on the target object

ignoreUnknown - should we ignore unknown properties (not found in the bean)

抛出:

InvalidPropertyException - if there is no such property or if the property isn't writable

PropertyBatchUpdateException - 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

另请参阅:

PropertyAccessor.setPropertyValues(PropertyValues, boolean, boolean)

setPropertyValues

public void setPropertyValues(PropertyValues pvs,
                              boolean ignoreUnknown,
                              boolean ignoreInvalid)
                       throws BeansException

从接口复制的说明: PropertyAccessor

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 PropertyBatchUpdateException containing all the individual errors. This exception can be examined later to see all binding errors. Properties that were successfully updated remain changed.

指定者:

setPropertyValues 在接口中 PropertyAccessor

参数:

pvs - PropertyValues to set on the target object

ignoreUnknown - 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 writable

PropertyBatchUpdateException - 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

getPropertyType

@Nullable
public Class<?> getPropertyType(String propertyPath)

从类复制的说明: PropertyEditorRegistrySupport

Determine the property type for the given property path.

Called by PropertyEditorRegistrySupport.findCustomEditor(java.lang.Class<?>, java.lang.String) if no required type has been specified, to be able to find a type-specific editor even if just given a property path.

The default implementation always returns null. BeanWrapperImpl overrides this with the standard getPropertyType method as defined by the BeanWrapper interface.

指定者:

getPropertyType 在接口中 PropertyAccessor

覆盖:

getPropertyType 在类中 PropertyEditorRegistrySupport

参数:

propertyPath - the property path to determine the type for

返回:

the type of the property, or null if not determinable

另请参阅:

PropertyAccessor.getPropertyType(String)

getPropertyValue

@Nullable
public abstract Object getPropertyValue(String propertyName)
                                            throws BeansException

Actually get the value of a property.

指定者:

getPropertyValue 在接口中 PropertyAccessor

参数:

propertyName - name of the property to get the value of

返回:

the value of the property

抛出:

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

public abstract void setPropertyValue(String propertyName,
                                      @Nullable
                                      Object value)
                               throws BeansException

Actually set a property value.

指定者:

setPropertyValue 在接口中 PropertyAccessor

参数:

propertyName - name of the property to set value of

value - the new value

抛出:

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 occurred

BeansException