org.apache.commons.beanutils
public class ConvertUtilsBean extends java.lang.Object
Utility methods for converting String scalar values to objects of the
specified Class, String arrays to arrays of the specified Class. The
actual Converter
instance to be used can be registered for each
possible destination Class. Unless you override them, standard
Converter
instances are provided for all of the following
destination Classes:
For backwards compatibility, the standard Converters for primitive
types (and the corresponding wrapper classes) return a defined
default value when a conversion error occurs. If you prefer to have a
ConversionException
thrown instead, replace the standard Converter
instances with instances created with the zero-arguments constructor. For
example, to cause the Converters for integers to throw an exception on
conversion errors, you could do this:
// No-args constructor gets the version that throws exceptions Converter myConverter = new org.apache.commons.beanutils.converter.IntegerConverter(); ConvertUtils.register(myConverter, Integer.TYPE); // Native type ConvertUtils.register(myConverter, Integer.class); // Wrapper class
Modifier and Type | Field and Description |
---|---|
private FastHashMap |
converters
The set of
Converter s that can be used to convert Strings
into objects of a specified Class, keyed by the destination Class. |
private java.lang.Boolean |
defaultBoolean
Deprecated.
Register replacement converters for Boolean.TYPE and
Boolean.class instead
|
private java.lang.Byte |
defaultByte
Deprecated.
Register replacement converters for Byte.TYPE and
Byte.class instead
|
private java.lang.Character |
defaultCharacter
Deprecated.
Register replacement converters for Character.TYPE and
Character.class instead
|
private java.lang.Double |
defaultDouble
Deprecated.
Register replacement converters for Double.TYPE and
Double.class instead
|
private java.lang.Float |
defaultFloat
Deprecated.
Register replacement converters for Float.TYPE and
Float.class instead
|
private java.lang.Integer |
defaultInteger
Deprecated.
Register replacement converters for Integer.TYPE and
Integer.class instead
|
private java.lang.Long |
defaultLong
Deprecated.
Register replacement converters for Long.TYPE and
Long.class instead
|
private static java.lang.Short |
defaultShort
Deprecated.
Register replacement converters for Short.TYPE and
Short.class instead
|
private org.apache.commons.logging.Log |
log
The
Log instance for this class. |
Constructor and Description |
---|
ConvertUtilsBean()
Construct a bean with standard converters registered
|
Modifier and Type | Method and Description |
---|---|
java.lang.String |
convert(java.lang.Object value)
Convert the specified value into a String.
|
java.lang.Object |
convert(java.lang.String[] values,
java.lang.Class clazz)
Convert an array of specified values to an array of objects of the
specified class (if possible).
|
java.lang.Object |
convert(java.lang.String value,
java.lang.Class clazz)
Convert the specified value to an object of the specified class (if
possible).
|
void |
deregister()
Remove all registered
Converter s, and re-establish the
standard Converters. |
void |
deregister(java.lang.Class clazz)
Remove any registered
Converter for the specified destination
Class . |
boolean |
getDefaultBoolean()
Deprecated.
Register replacement converters for Boolean.TYPE and
Boolean.class instead
|
byte |
getDefaultByte()
Deprecated.
Register replacement converters for Byte.TYPE and
Byte.class instead
|
char |
getDefaultCharacter()
Deprecated.
Register replacement converters for Character.TYPE and
Character.class instead
|
double |
getDefaultDouble()
Deprecated.
Register replacement converters for Double.TYPE and
Double.class instead
|
float |
getDefaultFloat()
Deprecated.
Register replacement converters for Float.TYPE and
Float.class instead
|
int |
getDefaultInteger()
Deprecated.
Register replacement converters for Integer.TYPE and
Integer.class instead
|
long |
getDefaultLong()
Deprecated.
Register replacement converters for Long.TYPE and
Long.class instead
|
short |
getDefaultShort()
Deprecated.
Register replacement converters for Short.TYPE and
Short.class instead
|
protected static ConvertUtilsBean |
getInstance()
Get singleton instance
|
Converter |
lookup(java.lang.Class clazz)
Look up and return any registered
Converter for the specified
destination class; if there is no registered Converter, return
null . |
private void |
register(java.lang.Class clazz,
Converter converter)
strictly for convenience since it has same parameter order as Map.put
|
void |
register(Converter converter,
java.lang.Class clazz)
Register a custom
Converter for the specified destination
Class , replacing any previously registered Converter. |
void |
setDefaultBoolean(boolean newDefaultBoolean)
Deprecated.
Register replacement converters for Boolean.TYPE and
Boolean.class instead
|
void |
setDefaultByte(byte newDefaultByte)
Deprecated.
Register replacement converters for Byte.TYPE and
Byte.class instead
|
void |
setDefaultCharacter(char newDefaultCharacter)
Deprecated.
Register replacement converters for Character.TYPE and
Character.class instead
|
void |
setDefaultDouble(double newDefaultDouble)
Deprecated.
Register replacement converters for Double.TYPE and
Double.class instead
|
void |
setDefaultFloat(float newDefaultFloat)
Deprecated.
Register replacement converters for Float.TYPE and
Float.class instead
|
void |
setDefaultInteger(int newDefaultInteger)
Deprecated.
Register replacement converters for Integer.TYPE and
Integer.class instead
|
void |
setDefaultLong(long newDefaultLong)
Deprecated.
Register replacement converters for Long.TYPE and
Long.class instead
|
void |
setDefaultShort(short newDefaultShort)
Deprecated.
Register replacement converters for Short.TYPE and
Short.class instead
|
private FastHashMap converters
Converter
s that can be used to convert Strings
into objects of a specified Class, keyed by the destination Class.private org.apache.commons.logging.Log log
Log
instance for this class.private java.lang.Boolean defaultBoolean
private java.lang.Byte defaultByte
private java.lang.Character defaultCharacter
private java.lang.Double defaultDouble
private java.lang.Float defaultFloat
private java.lang.Integer defaultInteger
private java.lang.Long defaultLong
private static java.lang.Short defaultShort
public ConvertUtilsBean()
protected static ConvertUtilsBean getInstance()
public boolean getDefaultBoolean()
public void setDefaultBoolean(boolean newDefaultBoolean)
public byte getDefaultByte()
public void setDefaultByte(byte newDefaultByte)
public char getDefaultCharacter()
public void setDefaultCharacter(char newDefaultCharacter)
public double getDefaultDouble()
public void setDefaultDouble(double newDefaultDouble)
public float getDefaultFloat()
public void setDefaultFloat(float newDefaultFloat)
public int getDefaultInteger()
public void setDefaultInteger(int newDefaultInteger)
public long getDefaultLong()
public void setDefaultLong(long newDefaultLong)
public short getDefaultShort()
public void setDefaultShort(short newDefaultShort)
public java.lang.String convert(java.lang.Object value)
Converter
for the
java.lang.String
class will be used, which allows
applications to customize Object->String conversions (the default
implementation simply uses toString()).value
- Value to be converted (may be null)public java.lang.Object convert(java.lang.String value, java.lang.Class clazz)
value
- Value to be converted (may be null)clazz
- Java class to be converted toConversionException
- if thrown by an underlying Converterpublic java.lang.Object convert(java.lang.String[] values, java.lang.Class clazz)
values
- Values to be converted (may be null)clazz
- Java array or element class to be converted toConversionException
- if thrown by an underlying Converterpublic void deregister()
Converter
s, and re-establish the
standard Converters.private void register(java.lang.Class clazz, Converter converter)
public void deregister(java.lang.Class clazz)
Converter
for the specified destination
Class
.clazz
- Class for which to remove a registered Converterpublic Converter lookup(java.lang.Class clazz)
Converter
for the specified
destination class; if there is no registered Converter, return
null
.clazz
- Class for which to return a registered Converterpublic void register(Converter converter, java.lang.Class clazz)
Converter
for the specified destination
Class
, replacing any previously registered Converter.converter
- Converter to be registeredclazz
- Destination class for conversions performed by this
ConverterCopyright (c) 2001-2004 - Apache Software Foundation