- Type Parameters:
J- the type of the keys to put in this map
K- the type of the keys to get in this map
U- the type of the values to put in this map
V- the type of the values to get in this map
public class TransformedSplitMap<J,K,U,V> extends AbstractIterableGetMapDecorator<K,V> implements Put<J,U>, SerializableDecorates another
Mapto transform objects that are added.
The Map put methods and Map.Entry setValue method 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.
Note that TransformedMap is not synchronized and is not thread-safe. If you wish to use this map from multiple threads concurrently, you must use appropriate synchronization. The simplest approach is to wrap this map using
Collections.synchronizedMap(Map). This class may throw exceptions when accessed by concurrent threads without synchronization.
The "put" and "get" type constraints of this class are mutually independent; contrast with
TransformedMapwhich, by virtue of its implementing
Map<K, V>, must be constructed in such a way that its read and write parameters are generalized to a common (super-)type. In practice this would often mean
>Object, Object>, defeating much of the usefulness of having parameterized types.
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description
put(J key, U value)Note that the return type is Object, rather than V as in the Map interface.
putAll(Map<? extends J,? extends U> mapToCopy)
transformingMap(Map<K,V> map, Transformer<? super J,? extends K> keyTransformer, Transformer<? super U,? extends V> valueTransformer)Factory method to create a transforming map.
Methods inherited from class org.apache.commons.collections4.splitmap.AbstractIterableGetMapDecorator
containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, mapIterator, remove, size, toString, values
public static <J,K,U,V> TransformedSplitMap<J,K,U,V> transformingMap(Map<K,V> map, Transformer<? super J,? extends K> keyTransformer, Transformer<? super U,? extends V> valueTransformer)Factory method to create a transforming map.
If there are any elements already in the map being decorated, they are NOT transformed.
- Type Parameters:
J- the input key type
K- the output key type
U- the input value type
V- the output value type
map- the map to decorate, must not be null
keyTransformer- the transformer to use for key conversion, must not be null
valueTransformer- the transformer to use for value conversion, must not be null
- a new transformed map
NullPointerException- if map or either of the transformers is null
putDescription copied from interface:
PutNote that the return type is Object, rather than V as in the Map interface. See the class Javadoc for further info.
- Specified by:
key- key with which the specified value is to be associated
value- value to be associated with the specified key
- the previous value associated with
nullif there was no mapping for
nullreturn can also indicate that the map previously associated
key, if the implementation supports
- See Also: