org.apache.commons.collections.collection

Class AbstractCollectionDecorator

public abstract class AbstractCollectionDecorator extends Object implements Collection

Decorates another Collection to provide additional behaviour.

Each method call made on this Collection is forwarded to the decorated Collection. This class is used as a framework on which to build to extensions such as synchronized and unmodifiable behaviour. The main advantage of decoration is that one decorator can wrap any implementation of Collection, whereas sub-classing requires a new class to be written for each implementation.

This implementation does not perform any special processing with iterator. Instead it simply returns the value from the wrapped collection. This may be undesirable, for example if you are trying to write an unmodifiable implementation it might provide a loophole.

Since: Commons Collections 3.0

Version: $Revision: 155406 $ $Date: 2005-02-26 12:55:26 +0000 (Sat, 26 Feb 2005) $

Author: Stephen Colebourne Paul Jack

Field Summary
protected Collectioncollection
The collection being decorated
Constructor Summary
protected AbstractCollectionDecorator()
Constructor only used in deserialization, do not use otherwise.
protected AbstractCollectionDecorator(Collection coll)
Constructor that wraps (not copies).
Method Summary
booleanadd(Object object)
booleanaddAll(Collection coll)
voidclear()
booleancontains(Object object)
booleancontainsAll(Collection coll)
booleanequals(Object object)
protected CollectiongetCollection()
Gets the collection being decorated.
inthashCode()
booleanisEmpty()
Iteratoriterator()
booleanremove(Object object)
booleanremoveAll(Collection coll)
booleanretainAll(Collection coll)
intsize()
Object[]toArray()
Object[]toArray(Object[] object)
StringtoString()

Field Detail

collection

protected Collection collection
The collection being decorated

Constructor Detail

AbstractCollectionDecorator

protected AbstractCollectionDecorator()
Constructor only used in deserialization, do not use otherwise.

Since: Commons Collections 3.1

AbstractCollectionDecorator

protected AbstractCollectionDecorator(Collection coll)
Constructor that wraps (not copies).

Parameters: coll the collection to decorate, must not be null

Throws: IllegalArgumentException if the collection is null

Method Detail

add

public boolean add(Object object)

addAll

public boolean addAll(Collection coll)

clear

public void clear()

contains

public boolean contains(Object object)

containsAll

public boolean containsAll(Collection coll)

equals

public boolean equals(Object object)

getCollection

protected Collection getCollection()
Gets the collection being decorated.

Returns: the decorated collection

hashCode

public int hashCode()

isEmpty

public boolean isEmpty()

iterator

public Iterator iterator()

remove

public boolean remove(Object object)

removeAll

public boolean removeAll(Collection coll)

retainAll

public boolean retainAll(Collection coll)

size

public int size()

toArray

public Object[] toArray()

toArray

public Object[] toArray(Object[] object)

toString

public String toString()
Copyright © 2001-2008 Apache Software Foundation. All Rights Reserved.