public interface TypeConverter
PropertyEditorRegistry
interface.
Note: Since TypeConverter implementations are typically based on
PropertyEditors
which aren't thread-safe,
TypeConverters themselves are not to be considered as thread-safe either.
SimpleTypeConverter
,
BeanWrapperImpl
Modifier and Type | Method and Description |
---|---|
<T> T |
convertIfNecessary(java.lang.Object value,
java.lang.Class<T> requiredType)
Convert the value to the required type (if necessary from a String).
|
<T> T |
convertIfNecessary(java.lang.Object value,
java.lang.Class<T> requiredType,
java.lang.reflect.Field field)
Convert the value to the required type (if necessary from a String).
|
<T> T |
convertIfNecessary(java.lang.Object value,
java.lang.Class<T> requiredType,
MethodParameter methodParam)
Convert the value to the required type (if necessary from a String).
|
@Nullable <T> T convertIfNecessary(@Nullable java.lang.Object value, @Nullable java.lang.Class<T> requiredType) throws TypeMismatchException
Conversions from String to any type will typically use the setAsText
method of the PropertyEditor class, or a Spring Converter in a ConversionService.
value
- the value to convertrequiredType
- the type we must convert to
(or null
if not known, for example in case of a collection element)TypeMismatchException
- if type conversion failedPropertyEditor.setAsText(String)
,
PropertyEditor.getValue()
,
ConversionService
,
Converter
@Nullable <T> T convertIfNecessary(@Nullable java.lang.Object value, @Nullable java.lang.Class<T> requiredType, @Nullable MethodParameter methodParam) throws TypeMismatchException
Conversions from String to any type will typically use the setAsText
method of the PropertyEditor class, or a Spring Converter in a ConversionService.
value
- the value to convertrequiredType
- 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
(for analysis of generic types; may be null
)TypeMismatchException
- if type conversion failedPropertyEditor.setAsText(String)
,
PropertyEditor.getValue()
,
ConversionService
,
Converter
@Nullable <T> T convertIfNecessary(@Nullable java.lang.Object value, @Nullable java.lang.Class<T> requiredType, @Nullable java.lang.reflect.Field field) throws TypeMismatchException
Conversions from String to any type will typically use the setAsText
method of the PropertyEditor class, or a Spring Converter in a ConversionService.
value
- the value to convertrequiredType
- 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
(for analysis of generic types; may be null
)TypeMismatchException
- if type conversion failedPropertyEditor.setAsText(String)
,
PropertyEditor.getValue()
,
ConversionService
,
Converter