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.
- Version:
- $Id$
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic String
Convert the specified value into a String.static Object
Convert the value to an object of the specified class (if possible).static Object
Convert an array of specified values to an array of objects of the specified class (if possible).static Object
Convert the specified value to an object of the specified class (if possible).static void
Remove all registeredConverter
s, and re-establish the standard Converters.static void
deregister
(Class<?> clazz) Remove any registeredConverter
for the specified destinationClass
.static boolean
Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadstatic byte
Deprecated.Register replacement converters for Byte.TYPE and Byte.class insteadstatic char
Deprecated.Register replacement converters for Character.TYPE and Character.class insteadstatic double
Deprecated.Register replacement converters for Double.TYPE and Double.class insteadstatic float
Deprecated.Register replacement converters for Float.TYPE and Float.class insteadstatic int
Deprecated.Register replacement converters for Integer.TYPE and Integer.class insteadstatic long
Deprecated.Register replacement converters for Long.TYPE and Long.class insteadstatic short
Deprecated.Register replacement converters for Short.TYPE and Short.class insteadstatic Converter
Look up and return any registeredConverter
for the specified destination class; if there is no registered Converter, returnnull
.static Converter
Look up and return any registeredConverter
for 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 void
Register a customConverter
for the specified destinationClass
, replacing any previously registered Converter.static void
setDefaultBoolean
(boolean newDefaultBoolean) Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadstatic void
setDefaultByte
(byte newDefaultByte) Deprecated.Register replacement converters for Byte.TYPE and Byte.class insteadstatic void
setDefaultCharacter
(char newDefaultCharacter) Deprecated.Register replacement converters for Character.TYPE and Character.class insteadstatic void
setDefaultDouble
(double newDefaultDouble) Deprecated.Register replacement converters for Double.TYPE and Double.class insteadstatic void
setDefaultFloat
(float newDefaultFloat) Deprecated.Register replacement converters for Float.TYPE and Float.class insteadstatic void
setDefaultInteger
(int newDefaultInteger) Deprecated.Register replacement converters for Integer.TYPE and Integer.class insteadstatic void
setDefaultLong
(long newDefaultLong) Deprecated.Register replacement converters for Long.TYPE and Long.class insteadstatic void
setDefaultShort
(short newDefaultShort) Deprecated.Register replacement converters for Short.TYPE and Short.class instead
-
Constructor Details
-
ConvertUtils
public ConvertUtils()
-
-
Method Details
-
getDefaultBoolean
Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadGets the default value for Boolean conversions.- Returns:
- The default Boolean value
-
setDefaultBoolean
Deprecated.Register replacement converters for Boolean.TYPE and Boolean.class insteadSets the default value for Boolean conversions.- Parameters:
newDefaultBoolean
- 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
-
setDefaultByte
Deprecated.Register replacement converters for Byte.TYPE and Byte.class insteadSets the default value for Byte conversions.- Parameters:
newDefaultByte
- 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
-
setDefaultCharacter
Deprecated.Register replacement converters for Character.TYPE and Character.class insteadSets the default value for Character conversions.- Parameters:
newDefaultCharacter
- 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
-
setDefaultDouble
Deprecated.Register replacement converters for Double.TYPE and Double.class insteadSets the default value for Double conversions.- Parameters:
newDefaultDouble
- 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
-
setDefaultFloat
Deprecated.Register replacement converters for Float.TYPE and Float.class insteadSets the default value for Float conversions.- Parameters:
newDefaultFloat
- 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
-
setDefaultInteger
Deprecated.Register replacement converters for Integer.TYPE and Integer.class insteadSets the default value for Integer conversions.- Parameters:
newDefaultInteger
- 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
-
setDefaultLong
Deprecated.Register replacement converters for Long.TYPE and Long.class insteadSets the default value for Long conversions.- Parameters:
newDefaultLong
- 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
-
setDefaultShort
Deprecated.Register replacement converters for Short.TYPE and Short.class insteadSets the default value for Short conversions.- Parameters:
newDefaultShort
- The default Short value
-
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 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:
-
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
-
deregister
public static void deregister()Remove all registered
Converter
s, and re-establish the standard Converters.For more details see
ConvertUtilsBean
.- See Also:
-
deregister
Remove any registered
Converter
for the specified destinationClass
.For more details see
ConvertUtilsBean
.- Parameters:
clazz
- Class for which to remove a registered Converter- See Also:
-
lookup
Look up and return any registered
Converter
for 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
Converter
ornull
if not found - See Also:
-
lookup
Look up and return any registeredConverter
for 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
Converter
ornull
if not found
-
register
Register a custom
Converter
for 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:
-
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
-