Package eu.simuline.util

Class CollectionsExt.ImmutableList<E>

java.lang.Object

java.util.AbstractCollection<E>

eu.simuline.util.CollectionsExt.AbstractImmutableCollection<java.util.List<E>,E>

eu.simuline.util.CollectionsExt.ImmutableList<E>

Type Parameters:

E - the class of the elements of this list.

All Implemented Interfaces:

java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>

Enclosing class:

CollectionsExt<E>

public static final class CollectionsExt.ImmutableList<E>
extends CollectionsExt.AbstractImmutableCollection<java.util.List<E>,E>
implements java.util.List<E>

A list which prevents being modified by throwing an exception for the modifying methods.

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.List<E>	list	The enclosed list containing the elements of this list.

Constructor Summary

Constructors

Constructor	Description
ImmutableList(java.util.List<E> list)
ImmutableList(java.util.Set<CollectionsExt.Modification> mods, java.util.List<E> list)

Method Summary

Modifier and Type	Method	Description
void	add(int index, E obj)
boolean	addAll(int index, java.util.Collection<? extends E> coll)
boolean	equals(java.lang.Object obj)
E	get(int index)
int	hashCode()
int	indexOf(java.lang.Object obj)
int	lastIndexOf(java.lang.Object obj)
java.util.ListIterator<E>	listIterator()
java.util.ListIterator<E>	listIterator(int index)
E	remove(int index)
void	replaceAll(java.util.function.UnaryOperator<E> operator)
E	set(int index, E element)
void	sort(java.util.Comparator<? super E> cmp)
java.util.List<E>	subList(int fromIndex, int toIndex)
java.util.List<E>	unrestricted()	Returns the underlying set without the restrictions imposed by this CollectionsExt.ImmutableCollection.

Methods inherited from class eu.simuline.util.CollectionsExt.AbstractImmutableCollection

add, addAll, allowedModifications, allowModification, allowModifications, clear, iterator, remove, removeAll, removeIf, retainAll, size, toString

Methods inherited from class java.util.AbstractCollection

contains, containsAll, isEmpty, toArray, toArray

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

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

Field Detail

list

private final java.util.List<E> list

The enclosed list containing the elements of this list.

Constructor Detail

ImmutableList

ImmutableList(java.util.List<E> list)

ImmutableList

ImmutableList(java.util.Set<CollectionsExt.Modification> mods,
              java.util.List<E> list)

Method Detail

unrestricted

public java.util.List<E> unrestricted()

Description copied from class: CollectionsExt.AbstractImmutableCollection

Returns the underlying set without the restrictions imposed by this CollectionsExt.ImmutableCollection. Note that the result may still throw UnsupportedOperationExceptions depending on the implementation.

Specified by:

unrestricted in class CollectionsExt.AbstractImmutableCollection<java.util.List<E>,E>

add

public void add(int index,
                E obj)

Specified by:

add in interface java.util.List<E>

Throws:

java.lang.UnsupportedOperationException - if either unrestricted() does not allow this operation or AddObj is no allowed operation according to CollectionsExt.AbstractImmutableCollection.allowedModifications().

addAll

public boolean addAll(int index,
                      java.util.Collection<? extends E> coll)

Specified by:

addAll in interface java.util.List<E>

Throws:

java.lang.UnsupportedOperationException - if either unrestricted() does not allow this operation or AddObj is no allowed operation according to CollectionsExt.AbstractImmutableCollection.allowedModifications(). In the latter case it does not matter, whether effectively it is tried to add objects which is the case only coll is not empty.

get

public E get(int index)

Specified by:

get in interface java.util.List<E>

hashCode

public int hashCode()

Specified by:

hashCode in interface java.util.Collection<E>

Specified by:

hashCode in interface java.util.List<E>

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Specified by:

equals in interface java.util.Collection<E>

Specified by:

equals in interface java.util.List<E>

Overrides:

equals in class java.lang.Object

indexOf

public int indexOf(java.lang.Object obj)

Specified by:

indexOf in interface java.util.List<E>

lastIndexOf

public int lastIndexOf(java.lang.Object obj)

Specified by:

lastIndexOf in interface java.util.List<E>

listIterator

public java.util.ListIterator<E> listIterator()

Specified by:

listIterator in interface java.util.List<E>

listIterator

public java.util.ListIterator<E> listIterator(int index)

Specified by:

listIterator in interface java.util.List<E>

remove

public E remove(int index)

Specified by:

remove in interface java.util.List<E>

Throws:

java.lang.UnsupportedOperationException - if either unrestricted() does not allow this operation or RemoveObj is no allowed operation according to CollectionsExt.AbstractImmutableCollection.allowedModifications().

set

public E set(int index,
             E element)

Specified by:

set in interface java.util.List<E>

Throws:

java.lang.UnsupportedOperationException - if either unrestricted() does not allow this operation or SetObj is no allowed operation according to CollectionsExt.AbstractImmutableCollection.allowedModifications(). In the latter case it does not matter, whether effectively it is tried to set an object which is the case only if element is not at place index in this.

replaceAll

public void replaceAll(java.util.function.UnaryOperator<E> operator)

Specified by:

replaceAll in interface java.util.List<E>

Throws:

java.lang.UnsupportedOperationException - if either unrestricted() does not allow this operation or SetObj is no allowed operation according to CollectionsExt.AbstractImmutableCollection.allowedModifications(). In the latter case it does not matter, whether effectively it is tried to replace an object which is the case only if operator really changes an object.

sort

public void sort(java.util.Comparator<? super E> cmp)

Specified by:

sort in interface java.util.List<E>

Throws:

java.lang.UnsupportedOperationException - if either unrestricted() does not allow this operation or SetObj is no allowed operation according to CollectionsExt.AbstractImmutableCollection.allowedModifications(). In the latter case it does not matter, whether effectively it is tried to replace an object which is the case only if this is not completely sorted according to cmp. This definition is in conjunction with the requirement, of List.sort(Comparator) that this exception is thrown iff the list iterator does not permit the ListIterator.set(Object) method.

subList

public java.util.List<E> subList(int fromIndex,
                                 int toIndex)

Specified by:

subList in interface java.util.List<E>