Package org.apache.commons.collections4.set

Class UnmodifiableNavigableSet<E>

java.lang.Object

org.apache.commons.collections4.collection.AbstractCollectionDecorator<E>

org.apache.commons.collections4.set.AbstractSetDecorator<E>

org.apache.commons.collections4.set.AbstractSortedSetDecorator<E>

org.apache.commons.collections4.set.AbstractNavigableSetDecorator<E>

org.apache.commons.collections4.set.UnmodifiableNavigableSet<E>

Type Parameters:

E - the type of the elements in this set

All Implemented Interfaces:

Serializable, Iterable<E>, Collection<E>, NavigableSet<E>, Set<E>, SortedSet<E>, Unmodifiable

public final class UnmodifiableNavigableSet<E>
extends AbstractNavigableSetDecorator<E>
implements Unmodifiable

Decorates another NavigableSet to ensure it can't be altered.

Attempts to modify it will result in an UnsupportedOperationException.

Since:

4.1

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private static final long	serialVersionUID	Serialization version

Constructor Summary

Constructors

Modifier	Constructor	Description
private	UnmodifiableNavigableSet(NavigableSet<E> set)	Constructor that wraps (not copies).

Method Summary

Modifier and Type	Method	Description
boolean	add(E object)
boolean	addAll(Collection<? extends E> coll)
void	clear()
Iterator<E>	descendingIterator()
NavigableSet<E>	descendingSet()
SortedSet<E>	headSet(E toElement)
NavigableSet<E>	headSet(E toElement, boolean inclusive)
Iterator<E>	iterator()
E	pollFirst()
E	pollLast()
private void	readObject(ObjectInputStream in)	Deserializes the collection in using a custom routine.
boolean	remove(Object object)
boolean	removeAll(Collection<?> coll)
boolean	removeIf(Predicate<? super E> filter)
boolean	retainAll(Collection<?> coll)
NavigableSet<E>	subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)
SortedSet<E>	subSet(E fromElement, E toElement)
SortedSet<E>	tailSet(E fromElement)
NavigableSet<E>	tailSet(E fromElement, boolean inclusive)
static <E> NavigableSet<E>	unmodifiableNavigableSet(NavigableSet<E> set)	Factory method to create an unmodifiable set.
private void	writeObject(ObjectOutputStream out)	Serializes this object to an ObjectOutputStream.

Methods inherited from class org.apache.commons.collections4.set.AbstractNavigableSetDecorator

ceiling, decorated, floor, higher, lower

Methods inherited from class org.apache.commons.collections4.set.AbstractSortedSetDecorator

comparator, first, last

Methods inherited from class org.apache.commons.collections4.set.AbstractSetDecorator

equals, hashCode

Methods inherited from class org.apache.commons.collections4.collection.AbstractCollectionDecorator

contains, containsAll, isEmpty, setCollection, size, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, stream

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

contains, containsAll, equals, hashCode, isEmpty, size, toArray, toArray

Methods inherited from interface java.util.SortedSet

comparator, first, last, spliterator

Field Details

serialVersionUID

private static final long serialVersionUID

Serialization version

See Also:

• Constant Field Values

Constructor Details

UnmodifiableNavigableSet

private UnmodifiableNavigableSet(NavigableSet<E> set)

Constructor that wraps (not copies).

Parameters:

set - the set to decorate, must not be null

Throws:

NullPointerException - if set is null

Method Details

unmodifiableNavigableSet

public static <E> NavigableSet<E> unmodifiableNavigableSet(NavigableSet<E> set)

Factory method to create an unmodifiable set.

Type Parameters:

E - the element type

Parameters:

set - the set to decorate, must not be null

Returns:

a new unmodifiable NavigableSet

Throws:

NullPointerException - if set is null

add

public boolean add(E object)

Specified by:

add in interface Collection<E>

Specified by:

add in interface Set<E>

Overrides:

add in class AbstractCollectionDecorator<E>

addAll

public boolean addAll(Collection<? extends E> coll)

Specified by:

addAll in interface Collection<E>

Specified by:

addAll in interface Set<E>

Overrides:

addAll in class AbstractCollectionDecorator<E>

clear

public void clear()

Specified by:

clear in interface Collection<E>

Specified by:

clear in interface Set<E>

Overrides:

clear in class AbstractCollectionDecorator<E>

descendingIterator

public Iterator<E> descendingIterator()

Specified by:

descendingIterator in interface NavigableSet<E>

Overrides:

descendingIterator in class AbstractNavigableSetDecorator<E>

descendingSet

public NavigableSet<E> descendingSet()

Specified by:

descendingSet in interface NavigableSet<E>

Overrides:

descendingSet in class AbstractNavigableSetDecorator<E>

headSet

public SortedSet<E> headSet(E toElement)

Specified by:

headSet in interface NavigableSet<E>

Specified by:

headSet in interface SortedSet<E>

Overrides:

headSet in class AbstractSortedSetDecorator<E>

headSet

public NavigableSet<E> headSet(E toElement,
 boolean inclusive)

Specified by:

headSet in interface NavigableSet<E>

Overrides:

headSet in class AbstractNavigableSetDecorator<E>

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Collection<E>

Specified by:

iterator in interface Iterable<E>

Specified by:

iterator in interface NavigableSet<E>

Specified by:

iterator in interface Set<E>

Overrides:

iterator in class AbstractCollectionDecorator<E>

pollFirst

public E pollFirst()

Specified by:

pollFirst in interface NavigableSet<E>

Overrides:

pollFirst in class AbstractNavigableSetDecorator<E>

Since:

4.5.0-M1

pollLast

public E pollLast()

Specified by:

pollLast in interface NavigableSet<E>

Overrides:

pollLast in class AbstractNavigableSetDecorator<E>

Since:

4.5.0-M1

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
ClassNotFoundException

Deserializes the collection in using a custom routine.

Parameters:

in - the input stream

Throws:

IOException - if an error occurs while reading from the stream

ClassNotFoundException - if an object read from the stream cannot be loaded

remove

public boolean remove(Object object)

Specified by:

remove in interface Collection<E>

Specified by:

remove in interface Set<E>

Overrides:

remove in class AbstractCollectionDecorator<E>

removeAll

public boolean removeAll(Collection<?> coll)

Specified by:

removeAll in interface Collection<E>

Specified by:

removeAll in interface Set<E>

Overrides:

removeAll in class AbstractCollectionDecorator<E>

removeIf

public boolean removeIf(Predicate<? super E> filter)

Specified by:

removeIf in interface Collection<E>

Overrides:

removeIf in class AbstractCollectionDecorator<E>

Since:

4.4

retainAll

public boolean retainAll(Collection<?> coll)

Specified by:

retainAll in interface Collection<E>

Specified by:

retainAll in interface Set<E>

Overrides:

retainAll in class AbstractCollectionDecorator<E>

subSet

public NavigableSet<E> subSet(E fromElement,
 boolean fromInclusive,
 E toElement,
 boolean toInclusive)

Specified by:

subSet in interface NavigableSet<E>

Overrides:

subSet in class AbstractNavigableSetDecorator<E>

subSet

public SortedSet<E> subSet(E fromElement,
 E toElement)

Specified by:

subSet in interface NavigableSet<E>

Specified by:

subSet in interface SortedSet<E>

Overrides:

subSet in class AbstractSortedSetDecorator<E>

tailSet

public SortedSet<E> tailSet(E fromElement)

Specified by:

tailSet in interface NavigableSet<E>

Specified by:

tailSet in interface SortedSet<E>

Overrides:

tailSet in class AbstractSortedSetDecorator<E>

tailSet

public NavigableSet<E> tailSet(E fromElement,
 boolean inclusive)

Specified by:

tailSet in interface NavigableSet<E>

Overrides:

tailSet in class AbstractNavigableSetDecorator<E>

writeObject

private void writeObject(ObjectOutputStream out)
                  throws IOException

Serializes this object to an ObjectOutputStream.

Parameters:

out - the target ObjectOutputStream.

Throws:

IOException - thrown when an I/O errors occur writing to the target stream.