org.apache.commons.beanutils.converters
Class StringArrayConverter
java.lang.Object
|
+--org.apache.commons.beanutils.converters.AbstractArrayConverter
|
+--org.apache.commons.beanutils.converters.StringArrayConverter
- All Implemented Interfaces:
- Converter
Deprecated. Replaced by the new ArrayConverter
implementation
- public final class StringArrayConverter
- extends AbstractArrayConverter
Standard Converter
implementation that converts an incoming
String into an array of String objects. On a conversion failure, returns
a specified default value or throws a ConversionException
depending
on how this instance is constructed.
There is also some special handling where the input is of type int[].
See method convert for more details.
- Since:
- 1.4
- Version:
- $Revision: 556229 $ $Date: 2007-07-14 07:11:19 +0100 (Sat, 14 Jul 2007) $
- Author:
- Craig R. McClanahan
Method Summary |
java.lang.Object |
convert(java.lang.Class type,
java.lang.Object value)
Deprecated. Convert the specified input object into an output object of the
specified type. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
StringArrayConverter
public StringArrayConverter()
- Deprecated.
- Create a
Converter
that will throw
a ConversionException
if a conversion error occurs.
StringArrayConverter
public StringArrayConverter(java.lang.Object defaultValue)
- Deprecated.
- Create a
Converter
that will return
the specified default value if a conversion error occurs.
- Parameters:
defaultValue
- The default value to be returned
convert
public java.lang.Object convert(java.lang.Class type,
java.lang.Object value)
- Deprecated.
- Convert the specified input object into an output object of the
specified type.
If the value is already of type String[] then it is simply returned
unaltered.
If the value is of type int[], then a String[] is returned where each
element in the string array is the result of calling Integer.toString
on the corresponding element of the int array. This was added as a
result of bugzilla request #18297 though there is not complete
agreement that this feature should have been added.
In all other cases, this method calls toString on the input object, then
assumes the result is a comma-separated list of values. The values are
split apart into the individual items and returned as the elements of an
array. See class AbstractArrayConverter for the exact input formats
supported.
- Overrides:
convert
in class AbstractArrayConverter
- Parameters:
type
- is the data type to which this value should be converted.
It is expected to be the class for type String[] (though this parameter
is actually ignored by this method).value
- is the input value to be converted. If null then the
default value is returned or an exception thrown if no default value
exists.- Returns:
- the converted value
- Throws:
ConversionException
- if conversion cannot be performed
successfully, or the input is null and there is no default value set
for this object.
Copyright © 2000-2007 The Apache Software Foundation. All Rights Reserved.