Class UnmodifiableBoundedCollection
- java.lang.Object
-
- org.apache.commons.collections.collection.AbstractCollectionDecorator
-
- org.apache.commons.collections.collection.AbstractSerializableCollectionDecorator
-
- org.apache.commons.collections.collection.UnmodifiableBoundedCollection
-
- All Implemented Interfaces:
Serializable
,Iterable
,Collection
,BoundedCollection
public final class UnmodifiableBoundedCollection extends AbstractSerializableCollectionDecorator implements BoundedCollection
UnmodifiableBoundedCollection
decorates anotherBoundedCollection
to ensure it can't be altered.If a BoundedCollection is first wrapped in some other collection decorator, such as synchronized or predicated, the BoundedCollection methods are no longer accessible. The factory on this class will attempt to retrieve the bounded nature by examining the package scope variables.
This class is Serializable from Commons Collections 3.1.
- Since:
- Commons Collections 3.0
- Version:
- $Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $
- Author:
- Stephen Colebourne
- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class org.apache.commons.collections.collection.AbstractCollectionDecorator
collection
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
add(Object object)
boolean
addAll(Collection coll)
void
clear()
static BoundedCollection
decorate(BoundedCollection coll)
Factory method to create an unmodifiable bounded collection.static BoundedCollection
decorateUsing(Collection coll)
Factory method to create an unmodifiable bounded collection.boolean
isFull()
Returns true if this collection is full and no new elements can be added.Iterator
iterator()
int
maxSize()
Gets the maximum size of the collection (the bound).boolean
remove(Object object)
boolean
removeAll(Collection coll)
boolean
retainAll(Collection coll)
-
Methods inherited from class org.apache.commons.collections.collection.AbstractCollectionDecorator
contains, containsAll, equals, getCollection, hashCode, isEmpty, 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
contains, containsAll, equals, hashCode, isEmpty, parallelStream, removeIf, size, spliterator, stream, toArray, toArray, toArray
-
-
-
-
Method Detail
-
decorate
public static BoundedCollection decorate(BoundedCollection coll)
Factory method to create an unmodifiable bounded collection.- Parameters:
coll
- theBoundedCollection
to decorate, must not be null- Returns:
- a new unmodifiable bounded collection
- Throws:
IllegalArgumentException
- if bag is null
-
decorateUsing
public static BoundedCollection decorateUsing(Collection coll)
Factory method to create an unmodifiable bounded collection.This method is capable of drilling down through up to 1000 other decorators to find a suitable BoundedCollection.
- Parameters:
coll
- theBoundedCollection
to decorate, must not be null- Returns:
- a new unmodifiable bounded collection
- Throws:
IllegalArgumentException
- if bag is null
-
iterator
public Iterator iterator()
- Specified by:
iterator
in interfaceCollection
- Specified by:
iterator
in interfaceIterable
- Overrides:
iterator
in classAbstractCollectionDecorator
-
add
public boolean add(Object object)
- Specified by:
add
in interfaceCollection
- Overrides:
add
in classAbstractCollectionDecorator
-
addAll
public boolean addAll(Collection coll)
- Specified by:
addAll
in interfaceCollection
- Overrides:
addAll
in classAbstractCollectionDecorator
-
clear
public void clear()
- Specified by:
clear
in interfaceCollection
- Overrides:
clear
in classAbstractCollectionDecorator
-
remove
public boolean remove(Object object)
- Specified by:
remove
in interfaceCollection
- Overrides:
remove
in classAbstractCollectionDecorator
-
removeAll
public boolean removeAll(Collection coll)
- Specified by:
removeAll
in interfaceCollection
- Overrides:
removeAll
in classAbstractCollectionDecorator
-
retainAll
public boolean retainAll(Collection coll)
- Specified by:
retainAll
in interfaceCollection
- Overrides:
retainAll
in classAbstractCollectionDecorator
-
isFull
public boolean isFull()
Description copied from interface:BoundedCollection
Returns true if this collection is full and no new elements can be added.- Specified by:
isFull
in interfaceBoundedCollection
- Returns:
true
if the collection is full
-
maxSize
public int maxSize()
Description copied from interface:BoundedCollection
Gets the maximum size of the collection (the bound).- Specified by:
maxSize
in interfaceBoundedCollection
- Returns:
- the maximum number of elements the collection can hold
-
-