public final class StringConverter extends AbstractConverter
Converter
implementation that converts an incoming
object into a java.lang.String object.
Note that ConvertUtils really is designed to do string->object conversions, and offers very little support for object->string conversions. The ConvertUtils/ConvertUtilsBean methods only select a converter to apply based upon the target type being converted to, and generally assume that the input is a string (by calling its toString method if needed).
This class is therefore just a dummy converter that converts its input into a string by calling the input object's toString method and returning that value.
It is possible to replace this converter with something that has a big if/else statement that selects behaviour based on the real type of the object being converted (or possibly has a map of converters, and looks them up based on the class of the input object). However this is not part of the existing ConvertUtils framework.
| Constructor and Description |
|---|
StringConverter()
Construct a java.lang.String Converter that throws
a
ConversionException if an error occurs. |
StringConverter(Object defaultValue)
Construct a java.lang.String Converter that returns
a default value if an error occurs.
|
| Modifier and Type | Method and Description |
|---|---|
protected <T> T |
convertToType(Class<T> type,
Object value)
Convert the specified input object into an output object of the
specified type.
|
protected Class<?> |
getDefaultType()
Return the default type this
Converter handles. |
conversionException, convert, convertArray, convertToString, getDefault, handleError, handleMissing, isUseDefault, setDefaultValue, toStringpublic StringConverter()
ConversionException if an error occurs.public StringConverter(Object defaultValue)
defaultValue - The default value to be returned
if the value to be converted is missing or an error
occurs converting the value.protected Class<?> getDefaultType()
Converter handles.getDefaultType in class AbstractConverterConverter handles.protected <T> T convertToType(Class<T> type, Object value) throws Throwable
convertToType in class AbstractConverterT - Target type of the conversion.type - Data type to which this value should be converted.value - The input value to be converted.Throwable - if an error occurs converting to the specified typeCopyright © 2000–2019 The Apache Software Foundation. All rights reserved.