org.apache.commons.collections.collection

Class TransformedCollection

java.lang.Object

org.apache.commons.collections.collection.AbstractCollectionDecorator

org.apache.commons.collections.collection.AbstractSerializableCollectionDecorator

org.apache.commons.collections.collection.TransformedCollection

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable, java.util.Collection

Direct Known Subclasses:

TransformedBag, TransformedBuffer, TransformedList, TransformedSet

public class TransformedCollection
extends AbstractSerializableCollectionDecorator

Decorates another Collection to transform objects that are added.

The add methods are affected by this class. Thus objects must be removed or searched for using their transformed form. For example, if the transformation converts Strings to Integers, you must use the Integer form to remove objects.

This class is Serializable from Commons Collections 3.1.

Since:

Commons Collections 3.0

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
boolean	add(java.lang.Object object)
boolean	addAll(java.util.Collection coll)
static java.util.Collection	decorate(java.util.Collection coll, Transformer transformer) Factory method to create a transforming collection.

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

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable

forEach

Method Detail

decorate

public static java.util.Collection decorate(java.util.Collection coll,
                                            Transformer transformer)

Factory method to create a transforming collection.

If there are any elements already in the collection being decorated, they are NOT transformed.

Parameters:

coll - the collection to decorate, must not be null

transformer - the transformer to use for conversion, must not be null

Returns:

a new transformed collection

Throws:

java.lang.IllegalArgumentException - if collection or transformer is null

add

public boolean add(java.lang.Object object)

Specified by:

add in interface java.util.Collection

Overrides:

add in class AbstractCollectionDecorator

addAll

public boolean addAll(java.util.Collection coll)

Specified by:

addAll in interface java.util.Collection

Overrides:

addAll in class AbstractCollectionDecorator