net.nicholaswilliams.java.licensing.immutable

Class ImmutableArrayList<E>

java.lang.Object

net.nicholaswilliams.java.licensing.immutable.ImmutableAbstractCollection<E>

net.nicholaswilliams.java.licensing.immutable.ImmutableArrayList<E>

All Implemented Interfaces:

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, Immutable

public final class ImmutableArrayList<E>
extends ImmutableAbstractCollection<E>
implements List<E>, Serializable, Cloneable

Wraps a list such that it cannot be modified. There is some overhead associated with this due to verification of hash codes on every call to prevent tampering with via reflection, but this is well worth it if your goal is security and you truly need an unmodifiable list.

Since:

1.0.0

Version:

1.0.0

Author:

Nick Williams

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ImmutableArrayList(List<E> list) Constructor that copies.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(int index, E e)
boolean	addAll(int index, Collection<? extends E> c)
ImmutableArrayList<E>	clone()
E	get(int index)
int	indexOf(Object o)
int	lastIndexOf(Object o)
ImmutableListIterator<E>	listIterator()
ImmutableListIterator<E>	listIterator(int index)
E	remove(int index)
E	set(int index, E e)
ImmutableArrayList<E>	subList(int fromIndex, int toIndex)

Methods inherited from class net.nicholaswilliams.java.licensing.immutable.ImmutableAbstractCollection

add, addAll, checkValidity, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Constructor Detail

ImmutableArrayList

public ImmutableArrayList(List<E> list)

Constructor that copies.

Parameters:

list - the list to decorate, must not be null

Throws:

IllegalArgumentException - if list is null

Method Detail

clone

public final ImmutableArrayList<E> clone()

Overrides:

clone in class Object

get

public final E get(int index)

Specified by:

get in interface List<E>

indexOf

public final int indexOf(Object o)

Specified by:

indexOf in interface List<E>

lastIndexOf

public final int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<E>

listIterator

public final ImmutableListIterator<E> listIterator()

Specified by:

listIterator in interface List<E>

listIterator

public final ImmutableListIterator<E> listIterator(int index)

Specified by:

listIterator in interface List<E>

subList

public final ImmutableArrayList<E> subList(int fromIndex,
                            int toIndex)

Specified by:

subList in interface List<E>

add

public final void add(int index,
       E e)

Specified by:

add in interface List<E>

addAll

public final boolean addAll(int index,
             Collection<? extends E> c)

Specified by:

addAll in interface List<E>

remove

public final E remove(int index)

Specified by:

remove in interface List<E>

set

public final E set(int index,
    E e)

Specified by:

set in interface List<E>