java.lang.Object | |
↳ | org.springframework.beans.PropertyEditorRegistrySupport |
Known Direct Subclasses |
Known Indirect Subclasses |
Base implementation of the PropertyEditorRegistry
interface.
Provides management of default editors and custom editors.
Mainly serves as base class for BeanWrapperImpl
.
setAsText(String)
setValue(Object)
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Find a custom property editor for the given type and property.
| |||||||||||
Return the associated ConversionService, if any.
| |||||||||||
Retrieve the default editor for the given property type, if any.
| |||||||||||
Determine whether this registry contains a custom editor
for the specified array/collection element.
| |||||||||||
Check whether the given editor instance is a shared editor, that is,
whether the given editor instance might be used concurrently.
| |||||||||||
Override the default editor for the specified type with the given property editor.
| |||||||||||
Register the given custom property editor for the given type and
property, or for all properties of the given type.
| |||||||||||
Register the given custom property editor for all properties of the given type.
| |||||||||||
This method is deprecated.
as of Spring 3.0, in favor of PropertyEditorRegistrars or ConversionService usage
| |||||||||||
Specify a Spring 3.0 ConversionService to use for converting
property values, as an alternative to JavaBeans PropertyEditors.
| |||||||||||
Activate config value editors which are only intended for configuration purposes,
such as
StringArrayPropertyEditor . |
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Copy the custom editors registered in this instance to the given target registry.
| |||||||||||
Copy the default editors registered in this instance to the given target registry.
| |||||||||||
Determine the property type for the given property path.
| |||||||||||
Guess the property type of the specified property from the registered
custom editors (provided that they were registered for a specific type).
| |||||||||||
Activate the default editors for this registry instance,
allowing for lazily registering default editors when needed.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.beans.PropertyEditorRegistry
|
Find a custom property editor for the given type and property.
requiredType | the type of the property (can be null if a property
is given but should be specified in any case for consistency checking) |
---|---|
propertyPath | the path of the property (name or nested path), or
null if looking for an editor for all properties of the given type |
null
if none
Return the associated ConversionService, if any.
Retrieve the default editor for the given property type, if any.
Lazily registers the default editors, if they are active.
requiredType | type of the property |
---|
null
if none foundDetermine whether this registry contains a custom editor for the specified array/collection element.
elementType | the target type of the element
(can be null if not known) |
---|---|
propertyPath | the property path (typically of the array/collection;
can be null if not known) |
Check whether the given editor instance is a shared editor, that is, whether the given editor instance might be used concurrently.
propertyEditor | the editor instance to check |
---|
Override the default editor for the specified type with the given property editor.
Note that this is different from registering a custom editor in that the editor semantically still is a default editor. A ConversionService will override such a default editor, whereas custom editors usually override the ConversionService.
requiredType | the type of the property |
---|---|
propertyEditor | the editor to register |
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.quantity" as the value of the 'propertyPath' argument to this method.
requiredType | the type of the property. This may be null
if a property is given but should be specified in any case, in particular in
case of a Collection - making clear whether the editor is supposed to apply
to the entire Collection itself or to each of its entries. So as a general rule:
Do not specify null here in case of a Collection/array! |
---|---|
propertyPath | the 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 |
Register the given custom property editor for all properties of the given type.
requiredType | the type of the property |
---|---|
propertyEditor | the editor to register |
This method is deprecated.
as of Spring 3.0, in favor of PropertyEditorRegistrars or ConversionService usage
Register the given custom property editor for all properties of the given type, indicating that the given instance is a shared editor that might be used concurrently.
requiredType | the type of the property |
---|---|
propertyEditor | the shared editor to register |
Specify a Spring 3.0 ConversionService to use for converting property values, as an alternative to JavaBeans PropertyEditors.
Activate config value editors which are only intended for configuration purposes,
such as StringArrayPropertyEditor
.
Those editors are not registered by default simply because they are in
general inappropriate for data binding purposes. Of course, you may register
them individually in any case, through registerCustomEditor(Class, PropertyEditor)
.
Copy the custom editors registered in this instance to the given target registry.
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. If this is null, all editors will be copied. |
Copy the default editors registered in this instance to the given target registry.
target | the target registry to copy to |
---|
Determine the property type for the given property path.
Called by findCustomEditor(Class, 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.
propertyPath | the property path to determine the type for |
---|
null
if not determinableGuess the property type of the specified property from the registered custom editors (provided that they were registered for a specific type).
propertyName | the name of the property |
---|
null
if not determinable
Activate the default editors for this registry instance, allowing for lazily registering default editors when needed.