org.apache.commons.beanutils.converters
Class AbstractArrayConverter

java.lang.Object
  extended by org.apache.commons.beanutils.converters.AbstractArrayConverter
All Implemented Interfaces:
Converter
Direct Known Subclasses:
BooleanArrayConverter, ByteArrayConverter, CharacterArrayConverter, DoubleArrayConverter, FloatArrayConverter, IntegerArrayConverter, LongArrayConverter, ShortArrayConverter, StringArrayConverter

Deprecated. Replaced by the new ArrayConverter implementation

public abstract class AbstractArrayConverter
extends Object
implements Converter

Convenience base class for converters that translate the String representation of an array into a corresponding array of primitives object. This class encapsulates the functionality required to parse the String into a list of String elements that can later be individually converted to the appropriate primitive type.

The input syntax accepted by the parseElements() method is designed to be compatible with the syntax used to initialize arrays in a Java source program, except that only String literal values are supported. For maximum flexibility, the surrounding '{' and '}' characters are optional, and individual elements may be separated by any combination of whitespace and comma characters.

Since:
1.4
Version:
$Revision: 690380 $ $Date: 2008-08-29 21:04:38 +0100 (Fri, 29 Aug 2008) $
Author:
Craig R. McClanahan

Field Summary
protected  Object defaultValue
          Deprecated. The default value specified to our Constructor, if any.
static Object NO_DEFAULT
          Deprecated. This is a special reference that can be passed as the "default object" to the constructor to indicate that no default is desired.
protected static String[] strings
          Deprecated. Model object for string arrays.
protected  boolean useDefault
          Deprecated. Should we return the default value on conversion errors?
 
Constructor Summary
AbstractArrayConverter()
          Deprecated. Create a Converter that will throw a ConversionException if a conversion error occurs.
AbstractArrayConverter(Object defaultValue)
          Deprecated. Create a Converter that will return the specified default value if a conversion error occurs.
 
Method Summary
abstract  Object convert(Class type, Object value)
          Deprecated. Convert the specified input object into an output object of the specified type.
protected  List parseElements(String svalue)
          Deprecated. Parse an incoming String of the form similar to an array initializer in the Java language into a List individual Strings for each element, according to the following rules.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NO_DEFAULT

public static final Object NO_DEFAULT
Deprecated. 
This is a special reference that can be passed as the "default object" to the constructor to indicate that no default is desired. Note that the value 'null' cannot be used for this purpose, as the caller may want a null to be returned as the default.

Since:
1.8.0

strings

protected static String[] strings
Deprecated. 

Model object for string arrays.


defaultValue

protected Object defaultValue
Deprecated. 
The default value specified to our Constructor, if any.


useDefault

protected boolean useDefault
Deprecated. 
Should we return the default value on conversion errors?

Constructor Detail

AbstractArrayConverter

public AbstractArrayConverter()
Deprecated. 
Create a Converter that will throw a ConversionException if a conversion error occurs.


AbstractArrayConverter

public AbstractArrayConverter(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
Since:
1.8.0
Method Detail

convert

public abstract Object convert(Class type,
                               Object value)
Deprecated. 
Convert the specified input object into an output object of the specified type. This method must be implemented by a concrete subclass.

Specified by:
convert in interface Converter
Parameters:
type - Data type to which this value should be converted
value - The input value to be converted
Returns:
The converted value
Throws:
ConversionException - if conversion cannot be performed successfully

parseElements

protected List parseElements(String svalue)
Deprecated. 

Parse an incoming String of the form similar to an array initializer in the Java language into a List individual Strings for each element, according to the following rules.

Parameters:
svalue - String value to be parsed
Returns:
The parsed list of String values
Throws:
ConversionException - if the syntax of svalue is not syntactically valid
NullPointerException - if svalue is null


Copyright © 2000-2008 The Apache Software Foundation. All Rights Reserved.