Class ConvertUtils
Utility methods for converting String scalar values to objects of the specified Class, String arrays to arrays of the specified Class.
For more details, see ConvertUtilsBean which provides the
implementations for these methods.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic StringConvert the specified value into a String.static ObjectConvert the value to an object of the specified class (if possible).static ObjectConvert an array of specified values to an array of objects of the specified class (if possible).static ObjectConvert the specified value to an object of the specified class (if possible).static voidRemove all registeredConverters, and re-establish the standard Converters.static voidderegister(Class<?> clazz) Remove any registeredConverterfor the specified destinationClass.static booleanDeprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadstatic byteDeprecated.Register replacement converters for Byte.TYPE and Byte.class insteadstatic charDeprecated.Register replacement converters for Character.TYPE and Character.class insteadstatic doubleDeprecated.Register replacement converters for Double.TYPE and Double.class insteadstatic floatDeprecated.Register replacement converters for Float.TYPE and Float.class insteadstatic intDeprecated.Register replacement converters for Integer.TYPE and Integer.class insteadstatic longDeprecated.Register replacement converters for Long.TYPE and Long.class insteadstatic shortDeprecated.Register replacement converters for Short.TYPE and Short.class insteadstatic ConverterLook up and return any registeredConverterfor the specified destination class; if there is no registered Converter, returnnull.static ConverterLook up and return any registeredConverterfor the specified source and destination class; if there is no registered Converter, returnnull.static <T> Class<T> primitiveToWrapper(Class<T> type) Change primitive Class types to the associated wrapper class.static voidRegister a customConverterfor the specified destinationClass, replacing any previously registered Converter.static voidsetDefaultBoolean(boolean newDefaultBoolean) Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadstatic voidsetDefaultByte(byte newDefaultByte) Deprecated.Register replacement converters for Byte.TYPE and Byte.class insteadstatic voidsetDefaultCharacter(char newDefaultCharacter) Deprecated.Register replacement converters for Character.TYPE and Character.class insteadstatic voidsetDefaultDouble(double newDefaultDouble) Deprecated.Register replacement converters for Double.TYPE and Double.class insteadstatic voidsetDefaultFloat(float newDefaultFloat) Deprecated.Register replacement converters for Float.TYPE and Float.class insteadstatic voidsetDefaultInteger(int newDefaultInteger) Deprecated.Register replacement converters for Integer.TYPE and Integer.class insteadstatic voidsetDefaultLong(long newDefaultLong) Deprecated.Register replacement converters for Long.TYPE and Long.class insteadstatic voidsetDefaultShort(short newDefaultShort) Deprecated.Register replacement converters for Short.TYPE and Short.class instead
-
Constructor Details
-
ConvertUtils
Deprecated.Will be private in 2.0.Deprecated, all methods are static.
-
-
Method Details
-
convert
Convert the specified value into a String.
For more details see
ConvertUtilsBean.- Parameters:
value- Value to be converted (may be null)- Returns:
- The converted String value or null if value is null
- See Also:
-
convert
Convert the value to an object of the specified class (if possible).
- Parameters:
value- Value to be converted (may be null)targetType- Class of the value to be converted to (must not be null)- Returns:
- The converted value
- Throws:
ConversionException- if thrown by an underlying Converter
-
convert
Convert the specified value to an object of the specified class (if possible). Otherwise, return a String representation of the value.
For more details see
ConvertUtilsBean.- Parameters:
value- Value to be converted (may be null)clazz- Java class to be converted to (must not be null)- Returns:
- The converted value
- See Also:
-
convert
Convert an array of specified values to an array of objects of the specified class (if possible).
For more details see
ConvertUtilsBean.- Parameters:
values- Array of values to be convertedclazz- Java array or element class to be converted to (must not be null)- Returns:
- The converted value
- See Also:
-
deregister
Remove all registered
Converters, and re-establish the standard Converters.For more details see
ConvertUtilsBean.- See Also:
-
deregister
Remove any registered
Converterfor the specified destinationClass.For more details see
ConvertUtilsBean.- Parameters:
clazz- Class for which to remove a registered Converter- See Also:
-
getDefaultBoolean
Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadGets the default value for Boolean conversions.- Returns:
- The default Boolean value
-
getDefaultByte
Deprecated.Register replacement converters for Byte.TYPE and Byte.class insteadGets the default value for Byte conversions.- Returns:
- The default Byte value
-
getDefaultCharacter
Deprecated.Register replacement converters for Character.TYPE and Character.class insteadGets the default value for Character conversions.- Returns:
- The default Character value
-
getDefaultDouble
Deprecated.Register replacement converters for Double.TYPE and Double.class insteadGets the default value for Double conversions.- Returns:
- The default Double value
-
getDefaultFloat
Deprecated.Register replacement converters for Float.TYPE and Float.class insteadGet the default value for Float conversions.- Returns:
- The default Float value
-
getDefaultInteger
Deprecated.Register replacement converters for Integer.TYPE and Integer.class insteadGets the default value for Integer conversions.- Returns:
- The default Integer value
-
getDefaultLong
Deprecated.Register replacement converters for Long.TYPE and Long.class insteadGets the default value for Long conversions.- Returns:
- The default Long value
-
getDefaultShort
Deprecated.Register replacement converters for Short.TYPE and Short.class insteadGets the default value for Short conversions.- Returns:
- The default Short value
-
lookup
Look up and return any registered
Converterfor the specified destination class; if there is no registered Converter, returnnull.For more details see
ConvertUtilsBean.- Parameters:
clazz- Class for which to return a registered Converter- Returns:
- The registered
Converterornullif not found - See Also:
-
lookup
Look up and return any registeredConverterfor the specified source and destination class; if there is no registered Converter, returnnull.- Parameters:
sourceType- Class of the value being convertedtargetType- Class of the value to be converted to- Returns:
- The registered
Converterornullif not found
-
primitiveToWrapper
Change primitive Class types to the associated wrapper class. This is useful for concrete converter implementations which typically treat primitive types like their corresponding wrapper types.- Type Parameters:
T- The type to be checked.- Parameters:
type- The class type to check.- Returns:
- The converted type.
- Since:
- 1.9
-
register
Register a custom
Converterfor the specified destinationClass, replacing any previously registered Converter.For more details see
ConvertUtilsBean.- Parameters:
converter- Converter to be registeredclazz- Destination class for conversions performed by this Converter- See Also:
-
setDefaultBoolean
Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadSets the default value for Boolean conversions.- Parameters:
newDefaultBoolean- The default Boolean value
-
setDefaultByte
Deprecated.Register replacement converters for Byte.TYPE and Byte.class insteadSets the default value for Byte conversions.- Parameters:
newDefaultByte- The default Byte value
-
setDefaultCharacter
Deprecated.Register replacement converters for Character.TYPE and Character.class insteadSets the default value for Character conversions.- Parameters:
newDefaultCharacter- The default Character value
-
setDefaultDouble
Deprecated.Register replacement converters for Double.TYPE and Double.class insteadSets the default value for Double conversions.- Parameters:
newDefaultDouble- The default Double value
-
setDefaultFloat
Deprecated.Register replacement converters for Float.TYPE and Float.class insteadSets the default value for Float conversions.- Parameters:
newDefaultFloat- The default Float value
-
setDefaultInteger
Deprecated.Register replacement converters for Integer.TYPE and Integer.class insteadSets the default value for Integer conversions.- Parameters:
newDefaultInteger- The default Integer value
-
setDefaultLong
Deprecated.Register replacement converters for Long.TYPE and Long.class insteadSets the default value for Long conversions.- Parameters:
newDefaultLong- The default Long value
-
setDefaultShort
Deprecated.Register replacement converters for Short.TYPE and Short.class insteadSets the default value for Short conversions.- Parameters:
newDefaultShort- The default Short value
-