ezvcard.parameter

Class VCardParameters.VCardParameterList<T>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<T>

ezvcard.parameter.VCardParameters.VCardParameterList<T>

All Implemented Interfaces:

Iterable<T>, Collection<T>, List<T>

Direct Known Subclasses:

VCardParameters.EnumParameterList

Enclosing class:

VCardParameters

public abstract class VCardParameters.VCardParameterList<T>
extends AbstractList<T>

A list that converts the raw string values of a parameter to another kind of value (for example, Integers).

This list is backed by the VCardParameters object. Any changes made to the list will affect the VCardParameters object and vice versa.

If a String value cannot be converted to the appropriate data type, an IllegalStateException is thrown.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	parameterName
protected List<String>	parameterValues

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
VCardParameterList(String parameterName)

Method Summary

Modifier and Type	Method and Description
protected abstract T	_asObject(String value) Converts a String value to its object form.
protected abstract String	_asString(T value) Converts the object to a String value for storing in the VCardParameters object.
protected IllegalStateException	_exception(String value, Exception thrown) Creates the exception that is thrown when the raw string value cannot be parsed into its object form.
void	add(int index, T value)
T	get(int index)
T	remove(int index)
T	set(int index, T value)
int	size()

Methods inherited from class java.util.AbstractList

add, addAll, clear, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, remove, removeAll, replaceAll, retainAll, sort, spliterator, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

parameterName

protected final String parameterName

parameterValues

protected final List<String> parameterValues

Constructor Detail

VCardParameterList

public VCardParameterList(String parameterName)

Parameters:

parameterName - the name of the parameter (case insensitive)

Method Detail

add

public void add(int index,
                T value)

Specified by:

add in interface List<T>

Overrides:

add in class AbstractList<T>

remove

public T remove(int index)

Specified by:

remove in interface List<T>

Overrides:

remove in class AbstractList<T>

get

public T get(int index)

Specified by:

get in interface List<T>

Specified by:

get in class AbstractList<T>

set

public T set(int index,
             T value)

Specified by:

set in interface List<T>

Overrides:

set in class AbstractList<T>

size

public int size()

Specified by:

size in interface Collection<T>

Specified by:

size in interface List<T>

Specified by:

size in class AbstractCollection<T>

_asString

protected abstract String _asString(T value)

Converts the object to a String value for storing in the VCardParameters object.

Parameters:

value - the value

Returns:

the string value

_asObject

protected abstract T _asObject(String value)
                        throws Exception

Converts a String value to its object form.

Parameters:

value - the string value

Returns:

the object

Throws:

Exception - if there is a problem parsing the string

_exception

protected IllegalStateException _exception(String value,
                                           Exception thrown)

Creates the exception that is thrown when the raw string value cannot be parsed into its object form.

Parameters:

value - the raw string value

thrown - the thrown exception

Returns:

the exception to throw