org.springframework.beans

Class TypeConverterDelegate

java.lang.Object

org.springframework.beans.TypeConverterDelegate

class TypeConverterDelegate
extends java.lang.Object

Internal helper class for converting property values to target types.

Works on a given PropertyEditorRegistrySupport instance. Used as a delegate by BeanWrapperImpl and SimpleTypeConverter.

Since:

2.0

Author:

Juergen Hoeller, Rob Harrop, Dave Syer

See Also:

BeanWrapperImpl, SimpleTypeConverter

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.Object	javaUtilOptionalEmpty Java 8's java.util.Optional.empty() instance
private static Log	logger
private PropertyEditorRegistrySupport	propertyEditorRegistry
private java.lang.Object	targetObject

Constructor Summary

Constructors

Constructor and Description
TypeConverterDelegate(PropertyEditorRegistrySupport propertyEditorRegistry) Create a new TypeConverterDelegate for the given editor registry.
TypeConverterDelegate(PropertyEditorRegistrySupport propertyEditorRegistry, java.lang.Object targetObject) Create a new TypeConverterDelegate for the given editor registry and bean instance.

Method Summary

Modifier and Type	Method and Description
private java.lang.Object	attemptToConvertStringToEnum(java.lang.Class<?> requiredType, java.lang.String trimmedValue, java.lang.Object currentConvertedValue)
private java.lang.String	buildIndexedPropertyName(java.lang.String propertyName, int index)
private java.lang.String	buildKeyedPropertyName(java.lang.String propertyName, java.lang.Object key)
private boolean	canCreateCopy(java.lang.Class<?> requiredType)
<T> T	convertIfNecessary(java.lang.Object newValue, java.lang.Class<T> requiredType, java.lang.reflect.Field field) Convert the value to the specified required type.
<T> T	convertIfNecessary(java.lang.Object newValue, java.lang.Class<T> requiredType, MethodParameter methodParam) Convert the value to the specified required type.
<T> T	convertIfNecessary(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue, java.lang.Class<T> requiredType) Convert the value to the required type for the specified property.
<T> T	convertIfNecessary(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue, java.lang.Class<T> requiredType, TypeDescriptor typeDescriptor) Convert the value to the required type (if necessary from a String), for the specified property.
private java.lang.Object	convertToTypedArray(java.lang.Object input, java.lang.String propertyName, java.lang.Class<?> componentType)
private java.util.Collection<?>	convertToTypedCollection(java.util.Collection<?> original, java.lang.String propertyName, java.lang.Class<?> requiredType, TypeDescriptor typeDescriptor)
private java.util.Map<?,?>	convertToTypedMap(java.util.Map<?,?> original, java.lang.String propertyName, java.lang.Class<?> requiredType, TypeDescriptor typeDescriptor)
private java.lang.Object	doConvertTextValue(java.lang.Object oldValue, java.lang.String newTextValue, java.beans.PropertyEditor editor) Convert the given text value using the given property editor.
private java.lang.Object	doConvertValue(java.lang.Object oldValue, java.lang.Object newValue, java.lang.Class<?> requiredType, java.beans.PropertyEditor editor) Convert the value to the required type (if necessary from a String), using the given property editor.
private java.beans.PropertyEditor	findDefaultEditor(java.lang.Class<?> requiredType) Find a default editor for the given type.

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Log logger

javaUtilOptionalEmpty

private static java.lang.Object javaUtilOptionalEmpty

Java 8's java.util.Optional.empty() instance

propertyEditorRegistry

private final PropertyEditorRegistrySupport propertyEditorRegistry

targetObject

private final java.lang.Object targetObject

Constructor Detail

TypeConverterDelegate

public TypeConverterDelegate(PropertyEditorRegistrySupport propertyEditorRegistry)

Create a new TypeConverterDelegate for the given editor registry.

Parameters:

propertyEditorRegistry - the editor registry to use

TypeConverterDelegate

public TypeConverterDelegate(PropertyEditorRegistrySupport propertyEditorRegistry,
                             java.lang.Object targetObject)

Create a new TypeConverterDelegate for the given editor registry and bean instance.

Parameters:

propertyEditorRegistry - the editor registry to use

targetObject - the target object to work on (as context that can be passed to editors)

Method Detail

convertIfNecessary

public <T> T convertIfNecessary(java.lang.Object newValue,
                                java.lang.Class<T> requiredType,
                                MethodParameter methodParam)
                         throws java.lang.IllegalArgumentException

Convert the value to the specified required type.

Parameters:

newValue - the proposed new value

requiredType - the type we must convert to (or null if not known, for example in case of a collection element)

methodParam - the method parameter that is the target of the conversion (may be null)

Returns:

the new value, possibly the result of type conversion

Throws:

java.lang.IllegalArgumentException - if type conversion failed

convertIfNecessary

public <T> T convertIfNecessary(java.lang.Object newValue,
                                java.lang.Class<T> requiredType,
                                java.lang.reflect.Field field)
                         throws java.lang.IllegalArgumentException

Convert the value to the specified required type.

Parameters:

newValue - the proposed new value

requiredType - the type we must convert to (or null if not known, for example in case of a collection element)

field - the reflective field that is the target of the conversion (may be null)

Returns:

the new value, possibly the result of type conversion

Throws:

java.lang.IllegalArgumentException - if type conversion failed

convertIfNecessary

public <T> T convertIfNecessary(java.lang.String propertyName,
                                java.lang.Object oldValue,
                                java.lang.Object newValue,
                                java.lang.Class<T> requiredType)
                         throws java.lang.IllegalArgumentException

Convert the value to the required type for the specified property.

Parameters:

propertyName - name of the property

oldValue - the previous value, if available (may be null)

newValue - the proposed new value

requiredType - the type we must convert to (or null if not known, for example in case of a collection element)

Returns:

the new value, possibly the result of type conversion

Throws:

java.lang.IllegalArgumentException - if type conversion failed

convertIfNecessary

public <T> T convertIfNecessary(java.lang.String propertyName,
                                java.lang.Object oldValue,
                                java.lang.Object newValue,
                                java.lang.Class<T> requiredType,
                                TypeDescriptor typeDescriptor)
                         throws java.lang.IllegalArgumentException

Convert the value to the required type (if necessary from a String), for the specified property.

Parameters:

propertyName - name of the property

oldValue - the previous value, if available (may be null)

newValue - the proposed new value

requiredType - the type we must convert to (or null if not known, for example in case of a collection element)

typeDescriptor - the descriptor for the target property or field

Returns:

the new value, possibly the result of type conversion

Throws:

java.lang.IllegalArgumentException - if type conversion failed

attemptToConvertStringToEnum

private java.lang.Object attemptToConvertStringToEnum(java.lang.Class<?> requiredType,
                                                      java.lang.String trimmedValue,
                                                      java.lang.Object currentConvertedValue)

findDefaultEditor

private java.beans.PropertyEditor findDefaultEditor(java.lang.Class<?> requiredType)

Find a default editor for the given type.

Parameters:

requiredType - the type to find an editor for

Returns:

the corresponding editor, or null if none

doConvertValue

private java.lang.Object doConvertValue(java.lang.Object oldValue,
                                        java.lang.Object newValue,
                                        java.lang.Class<?> requiredType,
                                        java.beans.PropertyEditor editor)

Convert the value to the required type (if necessary from a String), using the given property editor.

Parameters:

oldValue - the previous value, if available (may be null)

newValue - the proposed new value

requiredType - the type we must convert to (or null if not known, for example in case of a collection element)

editor - the PropertyEditor to use

Returns:

the new value, possibly the result of type conversion

Throws:

java.lang.IllegalArgumentException - if type conversion failed

doConvertTextValue

private java.lang.Object doConvertTextValue(java.lang.Object oldValue,
                                            java.lang.String newTextValue,
                                            java.beans.PropertyEditor editor)

Convert the given text value using the given property editor.

Parameters:

oldValue - the previous value, if available (may be null)

newTextValue - the proposed text value

editor - the PropertyEditor to use

Returns:

the converted value

convertToTypedArray

private java.lang.Object convertToTypedArray(java.lang.Object input,
                                             java.lang.String propertyName,
                                             java.lang.Class<?> componentType)

convertToTypedCollection

private java.util.Collection<?> convertToTypedCollection(java.util.Collection<?> original,
                                                         java.lang.String propertyName,
                                                         java.lang.Class<?> requiredType,
                                                         TypeDescriptor typeDescriptor)

convertToTypedMap

private java.util.Map<?,?> convertToTypedMap(java.util.Map<?,?> original,
                                             java.lang.String propertyName,
                                             java.lang.Class<?> requiredType,
                                             TypeDescriptor typeDescriptor)

buildIndexedPropertyName

private java.lang.String buildIndexedPropertyName(java.lang.String propertyName,
                                                  int index)

buildKeyedPropertyName

private java.lang.String buildKeyedPropertyName(java.lang.String propertyName,
                                                java.lang.Object key)

canCreateCopy

private boolean canCreateCopy(java.lang.Class<?> requiredType)