E
- the type of the elements in the collectionTransformedBag
, TransformedList
, TransformedQueue
, TransformedSet
public class TransformedCollection<E> extends AbstractCollectionDecorator<E>
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.
Modifier and Type | Field | Description |
---|---|---|
protected Transformer<? super E,? extends E> |
transformer |
The transformer to use
|
Modifier | Constructor | Description |
---|---|---|
protected |
TransformedCollection(java.util.Collection<E> coll,
Transformer<? super E,? extends E> transformer) |
Constructor that wraps (not copies).
|
Modifier and Type | Method | Description |
---|---|---|
boolean |
add(E object) |
|
boolean |
addAll(java.util.Collection<? extends E> coll) |
|
protected E |
transform(E object) |
Transforms an object.
|
protected java.util.Collection<E> |
transform(java.util.Collection<? extends E> coll) |
Transforms a collection.
|
static <E> TransformedCollection<E> |
transformedCollection(java.util.Collection<E> collection,
Transformer<? super E,? extends E> transformer) |
Factory method to create a transforming collection that will transform
existing contents of the specified collection.
|
static <E> TransformedCollection<E> |
transformingCollection(java.util.Collection<E> coll,
Transformer<? super E,? extends E> transformer) |
Factory method to create a transforming collection.
|
clear, contains, containsAll, decorated, isEmpty, iterator, remove, removeAll, retainAll, setCollection, size, toArray, toArray, toString
protected final Transformer<? super E,? extends E> transformer
protected TransformedCollection(java.util.Collection<E> coll, Transformer<? super E,? extends E> transformer)
If there are any elements already in the collection being decorated, they are NOT transformed.
coll
- the collection to decorate, must not be nulltransformer
- the transformer to use for conversion, must not be nulljava.lang.NullPointerException
- if collection or transformer is nullpublic static <E> TransformedCollection<E> transformingCollection(java.util.Collection<E> coll, Transformer<? super E,? extends E> transformer)
If there are any elements already in the collection being decorated, they
are NOT transformed.
Contrast this with transformedCollection(Collection, Transformer)
.
E
- the type of the elements in the collectioncoll
- the collection to decorate, must not be nulltransformer
- the transformer to use for conversion, must not be nulljava.lang.NullPointerException
- if collection or transformer is nullpublic static <E> TransformedCollection<E> transformedCollection(java.util.Collection<E> collection, Transformer<? super E,? extends E> transformer)
If there are any elements already in the collection being decorated, they
will be transformed by this method.
Contrast this with transformingCollection(Collection, Transformer)
.
E
- the type of the elements in the collectioncollection
- the collection to decorate, must not be nulltransformer
- the transformer to use for conversion, must not be nulljava.lang.NullPointerException
- if collection or transformer is nullprotected E transform(E object)
The transformer itself may throw an exception if necessary.
object
- the object to transformprotected java.util.Collection<E> transform(java.util.Collection<? extends E> coll)
The transformer itself may throw an exception if necessary.
coll
- the collection to transformpublic boolean add(E object)
add
in class AbstractCollectionDecorator<E>
public boolean addAll(java.util.Collection<? extends E> coll)
addAll
in class AbstractCollectionDecorator<E>
Copyright © 2001-2019 - Apache Software Foundation