Class AbstractArrayConverter
- All Implemented Interfaces:
Converter
- Direct Known Subclasses:
BooleanArrayConverter
,ByteArrayConverter
,CharacterArrayConverter
,DoubleArrayConverter
,FloatArrayConverter
,IntegerArrayConverter
,LongArrayConverter
,ShortArrayConverter
,StringArrayConverter
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:
- $Id$
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected Object
Deprecated.The default value specified to our Constructor, if any.static final Object
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[]
Deprecated.Model object for string arrays.protected boolean
Deprecated.Should we return the default value on conversion errors? -
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.Create aConverter
that will throw aConversionException
if a conversion error occurs.AbstractArrayConverter
(Object defaultValue) Deprecated.Create aConverter
that will return the specified default value if a conversion error occurs. -
Method Summary
Modifier and TypeMethodDescriptionabstract Object
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 aList
individual Strings for each element, according to the following rules.
-
Field Details
-
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
Deprecated.Model object for string arrays.
-
defaultValue
Deprecated.The default value specified to our Constructor, if any. -
useDefault
protected boolean useDefaultDeprecated.Should we return the default value on conversion errors?
-
-
Constructor Details
-
AbstractArrayConverter
public AbstractArrayConverter()Deprecated.Create aConverter
that will throw aConversionException
if a conversion error occurs. -
AbstractArrayConverter
Deprecated.Create aConverter
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 Details
-
convert
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 interfaceConverter
- Parameters:
type
- Data type to which this value should be convertedvalue
- The input value to be converted- Returns:
- The converted value
- Throws:
ConversionException
- if conversion cannot be performed successfully
-
parseElements
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.- The string is expected to be a comma-separated list of values.
- The string may optionally have matching '{' and '}' delimiters around the list.
- Whitespace before and after each element is stripped.
- Elements in the list may be delimited by single or double quotes. Within a quoted elements, the normal Java escape sequences are valid.
- Parameters:
svalue
- String value to be parsed- Returns:
- The parsed list of String values
- Throws:
ConversionException
- if the syntax ofsvalue
is not syntactically validNullPointerException
- ifsvalue
isnull
-
ArrayConverter
implementation