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, toString
public 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 AbstractConverter
Converter
handles.protected <T> T convertToType(Class<T> type, Object value) throws Throwable
convertToType
in class AbstractConverter
T
- 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–2016 The Apache Software Foundation. All rights reserved.