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

PropertyEditorRegistrySupport (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
Class PropertyEditorRegistrySupport

java.lang.Object
  extended by org.springframework.beans.PropertyEditorRegistrySupport
All Implemented Interfaces:
PropertyEditorRegistry
Direct Known Subclasses:
BeanWrapperImpl
public class PropertyEditorRegistrySupport
extends Object
implements PropertyEditorRegistry

Base implementation of the PropertyEditorRegistry interface. Provides management of default editors and custom editors. Mainly serves as base class for BeanWrapperImpl.

Since:
1.2.6
Author:
Juergen Hoeller
See Also:
PropertyEditorRegistry, BeanWrapperImpl, PropertyEditorManager, PropertyEditorSupport.setAsText(java.lang.String), PropertyEditorSupport.setValue(java.lang.Object)

Constructor Summary
PropertyEditorRegistrySupport()
           
 
Method Summary
protected  void copyCustomEditorsTo(PropertyEditorRegistry target, String nestedProperty)
          Copy the custom editors registered in this instance to the given target registry.
protected  void copyDefaultEditorsTo(PropertyEditorRegistrySupport target)
          Copy the default editors registered in this instance to the given target registry.
 PropertyEditor findCustomEditor(Class requiredType, String propertyPath)
          Find a custom property editor for the given type and property.
protected  PropertyEditor getDefaultEditor(Class requiredType)
          Retrieve the default editor for the given property type, if any.
protected  Class getPropertyType(String propertyPath)
          Determine the property type for the given property path.
protected  Class guessPropertyTypeFromEditors(String propertyName)
          Guess the property type of the specified property from the registered custom editors (provided that they were registered for a specific type).
 void registerCustomEditor(Class requiredType, PropertyEditor propertyEditor)
          Register the given custom property editor for all properties of the given type.
 void registerCustomEditor(Class requiredType, String propertyPath, PropertyEditor propertyEditor)
          Register the given custom property editor for the given type and property, or for all properties of the given type.
protected  void registerDefaultEditors()
          Register default editors in this instance, for restricted environments.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PropertyEditorRegistrySupport

public PropertyEditorRegistrySupport()
Method Detail

registerDefaultEditors

protected void registerDefaultEditors()
Register default editors in this instance, for restricted environments. We're not using the JRE's PropertyEditorManager to avoid potential SecurityExceptions when running in a SecurityManager.

Registers a CustomNumberEditor for all primitive number types, their corresponding wrapper types, BigInteger and BigDecimal.

See Also:
ByteArrayPropertyEditor, ClassEditor, CharacterEditor, CustomBooleanEditor, CustomNumberEditor, CustomCollectionEditor, FileEditor, InputStreamEditor, JndiTemplateEditor, LocaleEditor, PropertiesEditor, PropertyValuesEditor, ResourceArrayPropertyEditor, ResourceEditor, StringArrayPropertyEditor, TransactionAttributeEditor, TransactionAttributeSourceEditor, URLEditor

getDefaultEditor

protected PropertyEditor getDefaultEditor(Class requiredType)
Retrieve the default editor for the given property type, if any.

Parameters:
requiredType - type of the property
Returns:
the default editor, or null if none found

copyDefaultEditorsTo

protected void copyDefaultEditorsTo(PropertyEditorRegistrySupport target)
Copy the default editors registered in this instance to the given target registry.

Parameters:
target - the target registry to copy to

registerCustomEditor

public void registerCustomEditor(Class requiredType,
                                 PropertyEditor propertyEditor)
Description copied from interface: PropertyEditorRegistry
Register the given custom property editor for all properties of the given type.

Specified by:
registerCustomEditor in interface PropertyEditorRegistry
Parameters:
requiredType - type of the property
propertyEditor - editor to register

registerCustomEditor

public void registerCustomEditor(Class requiredType,
                                 String propertyPath,
                                 PropertyEditor propertyEditor)
Description copied from interface: PropertyEditorRegistry
Register the given custom property editor for the given type and property, or for all properties of the given type.

If the property path denotes an array or Collection property, the editor will get applied either to the array/Collection itself (the PropertyEditor has to create an array or Collection value) or to each element (the PropertyEditor has to create the element type), depending on the specified required type.

Note: Only one single registered custom editor per property path is supported. In the case of a Collection/array, do not register an editor for both the Collection/array and each element on the same property.

For example, if you wanted to register an editor for "items[n].quantity" (for all values n), you would use "items.quality" as the value of the 'propertyPath' argument to this method.

Specified by:
registerCustomEditor in interface PropertyEditorRegistry
Parameters:
requiredType - type of the property (can be null if a property is given but should be specified in any case for consistency checking)
propertyPath - path of the property (name or nested path), or null if registering an editor for all properties of the given type
propertyEditor - editor to register

findCustomEditor

public PropertyEditor findCustomEditor(Class requiredType,
                                       String propertyPath)
Description copied from interface: PropertyEditorRegistry
Find a custom property editor for the given type and property.

Specified by:
findCustomEditor in interface PropertyEditorRegistry
Parameters:
requiredType - type of the property (can be null if a property is given but should be specified in any case for consistency checking)
propertyPath - path of the property (name or nested path), or null if looking for an editor for all properties of the given type
Returns:
the registered editor, or null if none

getPropertyType

protected Class getPropertyType(String propertyPath)
Determine the property type for the given property path. Called by findCustomEditor if no required type has been specified, to be able to find a type-specific editor even if just given a property path.

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

Parameters:
propertyPath - the property path to determine the type for
Returns:
the type of the property, or null if not determinable
See Also:
BeanWrapper.getPropertyType(String)

guessPropertyTypeFromEditors

protected Class guessPropertyTypeFromEditors(String propertyName)
Guess the property type of the specified property from the registered custom editors (provided that they were registered for a specific type).

Parameters:
propertyName - the name of the property
Returns:
the property type, or null if not determinable

copyCustomEditorsTo

protected void copyCustomEditorsTo(PropertyEditorRegistry target,
                                   String nestedProperty)
Copy the custom editors registered in this instance to the given target registry.

Parameters:
target - the target registry to copy to
nestedProperty - the nested property path of the target registry, if any. If this is non-null, only editors registered for a path below this nested property will be copied.
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.