org.apache.commons.beanutils.converters
Class AbstractArrayConverter
java.lang.Object
org.apache.commons.beanutils.converters.AbstractArrayConverter
- All Implemented Interfaces:
- Converter
- Direct Known Subclasses:
- BooleanArrayConverter, ByteArrayConverter, CharacterArrayConverter, DoubleArrayConverter, FloatArrayConverter, IntegerArrayConverter, LongArrayConverter, ShortArrayConverter, StringArrayConverter
- public abstract class AbstractArrayConverter
- extends java.lang.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: 1.3 $ $Date: 2003/01/15 21:59:40 $
- Author:
- Craig R. McClanahan
| Field Summary |
protected java.lang.Object |
defaultValue
The default value specified to our Constructor, if any. |
protected static java.lang.String[] |
strings
Model object for string arrays. |
protected boolean |
useDefault
Should we return the default value on conversion errors? |
| Method Summary |
abstract java.lang.Object |
convert(java.lang.Class type, java.lang.Object value)
Convert the specified input object into an output object of the specified type. |
protected java.util.List |
parseElements(java.lang.String svalue)
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 |
defaultValue
protected java.lang.Object defaultValue
-
The default value specified to our Constructor, if any.
strings
protected static java.lang.String[] strings
-
Model object for string arrays.
useDefault
protected boolean useDefault
-
Should we return the default value on conversion errors?
AbstractArrayConverter
public AbstractArrayConverter()
convert
public abstract java.lang.Object convert(java.lang.Class type,
java.lang.Object value)
-
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
- Throws:
ConversionException - if conversion cannot be performed successfully
parseElements
protected java.util.List parseElements(java.lang.String svalue)
-
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.
- The string must have matching '{' and '}' delimiters around a comma-delimited list of values.
- Whitespace before and after each element is stripped.
- If an element is itself delimited by matching single or double quotes, the usual rules for interpreting a quoted String apply.
-
-
- Parameters:
svalue - String value to be parsed
- Throws:
ConversionException - if the syntax of svalue is not syntactically valid
java.lang.NullPointerException - if svalue is null
Please see keelframework.org for information about new Keel releases.