org.apache.commons.collections.collection
public class TransformedCollection extends AbstractSerializableCollectionDecorator
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
Version: $Revision: 155406 $ $Date: 2005-02-26 12:55:26 +0000 (Sat, 26 Feb 2005) $
Field Summary | |
---|---|
protected Transformer | transformer The transformer to use |
Constructor Summary | |
---|---|
protected | TransformedCollection(Collection coll, Transformer transformer)
Constructor that wraps (not copies).
|
Method Summary | |
---|---|
boolean | add(Object object) |
boolean | addAll(Collection coll) |
static Collection | decorate(Collection coll, Transformer transformer)
Factory method to create a transforming collection.
|
protected Object | transform(Object object)
Transforms an object.
|
protected Collection | transform(Collection coll)
Transforms a 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
Throws: IllegalArgumentException if collection or transformer is null
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: IllegalArgumentException if collection or transformer is null
The transformer itself may throw an exception if necessary.
Parameters: object the object to transform
Returns: a transformed object
The transformer itself may throw an exception if necessary.
Parameters: coll the collection to transform
Returns: a transformed object