|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.commons.beanutils.converters.AbstractConverter
public abstract class AbstractConverter
Base Converter
implementation that provides the structure
for handling conversion to and from a specified type.
This implementation provides the basic structure for
converting to/from a specified type optionally using a default
value or throwing a ConversionException
if a
conversion error occurs.
Implementations should provide conversion to the specified
type and from the specified type to a String
value
by implementing the following methods:
convertToString(value)
- convert to a String
(default implementation uses the objects toString()
method).convertToType(Class, value)
- convert
to the specified type
Field Summary | |
---|---|
private static java.lang.String |
DEFAULT_CONFIG_MSG
Debug logging message to indicate default value configuration |
private java.lang.Object |
defaultValue
The default value specified to our Constructor, if any. |
private org.apache.commons.logging.Log |
log
Logging for this instance. |
private static java.lang.String |
PACKAGE
Current package name |
private boolean |
useDefault
Should we return the default value on conversion errors? |
Constructor Summary | |
---|---|
AbstractConverter()
Construct a Converter that throws a ConversionException if an error occurs. |
|
AbstractConverter(java.lang.Object defaultValue)
Construct a Converter that returns a default value if an error occurs. |
Method Summary | |
---|---|
java.lang.Object |
convert(java.lang.Class type,
java.lang.Object value)
Convert the input object into an output object of the specified type. |
protected java.lang.Object |
convertArray(java.lang.Object value)
Return the first element from an Array (or Collection) or the value unchanged if not an Array (or Collection). |
protected java.lang.String |
convertToString(java.lang.Object value)
Convert the input object into a String. |
protected abstract java.lang.Object |
convertToType(java.lang.Class type,
java.lang.Object value)
Convert the input object into an output object of the specified type. |
protected java.lang.Object |
getDefault(java.lang.Class type)
Return the default value for conversions to the specified type. |
protected abstract java.lang.Class |
getDefaultType()
Return the default type this Converter handles. |
protected java.lang.Object |
handleError(java.lang.Class type,
java.lang.Object value,
java.lang.Throwable cause)
Handle Conversion Errors. |
protected java.lang.Object |
handleMissing(java.lang.Class type)
Handle missing values. |
boolean |
isUseDefault()
Indicates whether a default value will be returned or exception thrown in the event of a conversion error. |
(package private) org.apache.commons.logging.Log |
log()
Accessor method for Log instance. |
(package private) java.lang.Class |
primitive(java.lang.Class type)
Change primitve Class types to the associated wrapper class. |
protected void |
setDefaultValue(java.lang.Object defaultValue)
Set the default value, converting as required. |
java.lang.String |
toString()
Provide a String representation of this converter. |
(package private) java.lang.String |
toString(java.lang.Class type)
Provide a String representation of a java.lang.Class . |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
private static final java.lang.String DEFAULT_CONFIG_MSG
private static final java.lang.String PACKAGE
private transient org.apache.commons.logging.Log log
private boolean useDefault
private java.lang.Object defaultValue
Constructor Detail |
---|
public AbstractConverter()
ConversionException
if an error occurs.
public AbstractConverter(java.lang.Object defaultValue)
defaultValue
- The default value to be returned
if the value to be converted is missing or an error
occurs converting the value.Method Detail |
---|
public boolean isUseDefault()
true
if a default value will be returned for
conversion errors or false
if a ConversionException
will be thrown.public java.lang.Object convert(java.lang.Class type, java.lang.Object value)
convert
in interface Converter
type
- Data type to which this value should be convertedvalue
- The input value to be converted
ConversionException
- if conversion cannot be performed
successfully and no default is specified.protected java.lang.String convertToString(java.lang.Object value) throws java.lang.Throwable
N.B.This implementation simply uses the value's
toString()
method and should be overriden if a
more sophisticated mechanism for conversion to a String
is required.
value
- The input value to be converted.
java.lang.Throwable
- if an error occurs converting to a Stringprotected abstract java.lang.Object convertToType(java.lang.Class type, java.lang.Object value) throws java.lang.Throwable
Typical implementations will provide a minimum of
String --> type
conversion.
type
- Data type to which this value should be converted.value
- The input value to be converted.
java.lang.Throwable
- if an error occurs converting to the specified typeprotected java.lang.Object convertArray(java.lang.Object value)
value
- The value to convert
protected java.lang.Object handleError(java.lang.Class type, java.lang.Object value, java.lang.Throwable cause)
If a default value has been specified then it is returned otherwise a ConversionException is thrown.
type
- Data type to which this value should be converted.value
- The input value to be convertedcause
- The exception thrown by the convert
method
ConversionException
- if no default value has been
specified for this Converter
.protected java.lang.Object handleMissing(java.lang.Class type)
If a default value has been specified then it is returned otherwise a ConversionException is thrown.
type
- Data type to which this value should be converted.
ConversionException
- if no default value has been
specified for this Converter
.protected void setDefaultValue(java.lang.Object defaultValue)
If the default value is different from the type the
Converter
handles, it will be converted
to the handled type.
defaultValue
- The default value to be returned
if the value to be converted is missing or an error
occurs converting the value.
ConversionException
- if an error occurs converting
the default valueprotected abstract java.lang.Class getDefaultType()
Converter
handles.
Converter
handles.protected java.lang.Object getDefault(java.lang.Class type)
type
- Data type to which this value should be converted.
public java.lang.String toString()
toString
in class java.lang.Object
org.apache.commons.logging.Log log()
The Log instance variable is transient and accessing it through this method ensures it is re-initialized when this instance is de-serialized.
java.lang.Class primitive(java.lang.Class type)
type
- The class type to check.
java.lang.String toString(java.lang.Class type)
java.lang.Class
.
type
- The java.lang.Class
.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |