com.phloc.commons.collections.list

Class SafeArrayList<ELEMENTTYPE>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<ELEMENTTYPE>

com.phloc.commons.collections.list.SafeArrayList<ELEMENTTYPE>

Type Parameters:

ELEMENTTYPE - The type of the elements in the list

All Implemented Interfaces:

IHasSize, Serializable, Cloneable, Iterable<ELEMENTTYPE>, Collection<ELEMENTTYPE>, List<ELEMENTTYPE>, RandomAccess

@NotThreadSafe
public class SafeArrayList<ELEMENTTYPE>
extends ArrayList<ELEMENTTYPE>
implements IHasSize

This is a specialized ArrayList that can handle read accesses on list items that are not yet in the container. If get(int) is called with an index that would normally throw an ArrayIndexOutOfBoundsException this class will fill all indices between the current ArrayList.size() and the desired index with values provided by an IFactory. If you don't pass an IFactory in the constructor a default factory returning null values is used.

Author:

Philip

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
SafeArrayList()
SafeArrayList(IFactory<ELEMENTTYPE> aFactory)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object o)
ELEMENTTYPE	get(int nIndex)
int	hashCode()
ELEMENTTYPE	set(int nIndex, ELEMENTTYPE aElement)
String	toString()

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeRange, retainAll, size, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractCollection

containsAll

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.phloc.commons.IHasSize

isEmpty, size

Methods inherited from interface java.util.List

containsAll

Constructor Detail

SafeArrayList

public SafeArrayList()

SafeArrayList

public SafeArrayList(@Nonnull
             IFactory<ELEMENTTYPE> aFactory)

Method Detail

get

public ELEMENTTYPE get(@Nonnegative
              int nIndex)

Specified by:

get in interface List<ELEMENTTYPE>

Overrides:

get in class ArrayList<ELEMENTTYPE>

set

public ELEMENTTYPE set(@Nonnegative
              int nIndex,
              @Nonnull
              ELEMENTTYPE aElement)

Specified by:

set in interface List<ELEMENTTYPE>

Overrides:

set in class ArrayList<ELEMENTTYPE>

equals

public boolean equals(Object o)

Specified by:

equals in interface Collection<ELEMENTTYPE>

Specified by:

equals in interface List<ELEMENTTYPE>

Overrides:

equals in class AbstractList<ELEMENTTYPE>

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<ELEMENTTYPE>

Specified by:

hashCode in interface List<ELEMENTTYPE>

Overrides:

hashCode in class AbstractList<ELEMENTTYPE>

toString

public String toString()

Overrides:

toString in class AbstractCollection<ELEMENTTYPE>