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

@Deprecated public abstract class AbstractArrayConverter extends Object implements Converter
Deprecated.
Replaced by the new ArrayConverter implementation

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

    Fields
    Modifier and Type
    Field
    Description
    protected 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

    Constructors
    Constructor
    Description
    Deprecated.
    Create a Converter that will throw a ConversionException if a conversion error occurs.
    Deprecated.
    Create a Converter that will return the specified default value if a conversion error occurs.
  • Method Summary

    Modifier and Type
    Method
    Description
    abstract Object
    convert(Class type, Object value)
    Deprecated.
    Convert the specified input object into an output object of the specified type.
    protected List
    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 Details

    • 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 Details

    • 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 Details

    • 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.

      • 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 of svalue is not syntactically valid
      NullPointerException - if svalue is null