| Convert the specified input object into an output object of type
array-of-boolean.
If the input value is null, then the default value specified in the
constructor is returned. If no such value was provided, then a
ConversionException is thrown instead.
If the input value is of type String[] then the returned array shall
be of the same size as this array, with a true or false value in each
array element depending on the result of applying method
BooleanConverter.convert to each string.
For all other types of value, the object's toString method is
expected to return a string containing a comma-separated list of
values, eg "true, false, true". See the documentation for
AbstractArrayConverter.parseElements for more information on
the exact formats supported.
If the result of value.toString() cannot be split into separate
words, then the default value is also returned (or an exception thrown).
If any of the elements in the value array (or the elements resulting
from splitting up value.toString) are not recognised by the
BooleanConverter associated with this object, then what happens depends
on whether that BooleanConverter has a default value or not: if it does,
then that unrecognised element is converted into the BooleanConverter's
default value. If the BooleanConverter does not have a default
value, then the default value for this object is returned as the
complete conversion result (not just for the element), or an
exception is thrown if this object has no default value defined.
Parameters:
type - is the type to which this value should be converted. In thecase of this BooleanArrayConverter class, this value is ignored.
Parameters:
value - is the input value to be converted. an object of type boolean[], or the default value if there wasany sort of error during conversion and the constructorwas provided with a default value.
exception:
ConversionException - if conversion cannot be performedsuccessfully and the constructor was not provided with a defaultvalue to return on conversion failure.
exception:
NullPointerException - if value is an array, and any of thearray elements are null. |
