Class TransformedMap<K,V> 
- Type Parameters:
- K- the type of the keys in this map
- V- the type of the values in this map
- All Implemented Interfaces:
- Serializable,- Map<K,,- V> - Get<K,,- V> - IterableGet<K,,- V> - IterableMap<K,,- V> - Put<K,- V> 
- Direct Known Subclasses:
- TransformedSortedMap
Map to 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.
 
This class is Serializable from Commons Collections 3.1.
- Since:
- 3.0
- See Also:
- 
Nested Class Summary
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected final Transformer<? super K, ? extends K> The transformer to use for the keyprotected final Transformer<? super V, ? extends V> The transformer to use for the value
- 
Constructor SummaryConstructorsModifierConstructorDescriptionprotectedTransformedMap(Map<K, V> map, Transformer<? super K, ? extends K> keyTransformer, Transformer<? super V, ? extends V> valueTransformer) Constructor that wraps (not copies).
- 
Method SummaryModifier and TypeMethodDescriptionprotected VcheckSetValue(V value) Override to transform the value when usingsetValue.entrySet()Gets a set view of the mappings contained in this map.protected booleanOverride to only return true when there is a value transformer.Associates the specified value with the specified key in this map.voidCopies all of the mappings from the specified map to this map.static <K,V> TransformedMap <K, V> transformedMap(Map<K, V> map, Transformer<? super K, ? extends K> keyTransformer, Transformer<? super V, ? extends V> valueTransformer) Factory method to create a transforming map that will transform existing contents of the specified map.static <K,V> TransformedMap <K, V> transformingMap(Map<K, V> map, Transformer<? super K, ? extends K> keyTransformer, Transformer<? super V, ? extends V> valueTransformer) Factory method to create a transforming map.protected KtransformKey(K object) Transforms a key.transformMap(Map<? extends K, ? extends V> map) Transforms a map.protected VtransformValue(V object) Transforms a value.Methods inherited from class org.apache.commons.collections4.map.AbstractMapDecoratorclear, containsKey, containsValue, decorated, equals, get, hashCode, isEmpty, keySet, remove, size, toString, valuesMethods inherited from class org.apache.commons.collections4.map.AbstractIterableMapmapIteratorMethods inherited from class java.lang.Objectclone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface java.util.Mapcompute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll
- 
Field Details- 
keyTransformerThe transformer to use for the key
- 
valueTransformerThe transformer to use for the value
 
- 
- 
Constructor Details- 
TransformedMapprotected TransformedMap(Map<K, V> map, Transformer<? super K, ? extends K> keyTransformer, Transformer<? super V, ? extends V> valueTransformer) Constructor that wraps (not copies).If there are any elements already in the collection being decorated, they are NOT transformed. - Parameters:
- map- the map to decorate, must not be null
- keyTransformer- the transformer to use for key conversion, null means no conversion
- valueTransformer- the transformer to use for value conversion, null means no conversion
- Throws:
- NullPointerException- if map is null
 
 
- 
- 
Method Details- 
transformedMappublic static <K,V> TransformedMap<K,V> transformedMap(Map<K, V> map, Transformer<? super K, ? extends K> keyTransformer, Transformer<? super V, ? extends V> valueTransformer) Factory method to create a transforming map that will transform existing contents of the specified map.If there are any elements already in the map being decorated, they will be transformed by this method. Contrast this with transformingMap(Map, Transformer, Transformer).- Type Parameters:
- K- the key type
- V- the value type
- Parameters:
- map- the map to decorate, must not be null
- keyTransformer- the transformer to use for key conversion, null means no transformation
- valueTransformer- the transformer to use for value conversion, null means no transformation
- Returns:
- a new transformed map
- Throws:
- NullPointerException- if map is null
- Since:
- 4.0
 
- 
transformingMappublic static <K,V> TransformedMap<K,V> transformingMap(Map<K, V> map, Transformer<? super K, ? extends K> keyTransformer, Transformer<? super V, ? 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. Contrast this with transformedMap(Map, Transformer, Transformer).- Type Parameters:
- K- the key type
- V- the value type
- Parameters:
- map- the map to decorate, must not be null
- keyTransformer- the transformer to use for key conversion, null means no transformation
- valueTransformer- the transformer to use for value conversion, null means no transformation
- Returns:
- a new transformed map
- Throws:
- NullPointerException- if map is null
- Since:
- 4.0
 
- 
checkSetValueOverride to transform the value when usingsetValue.- Parameters:
- value- the value to transform
- Returns:
- the transformed value
- Since:
- 3.1
 
- 
isSetValueCheckingOverride to only return true when there is a value transformer.- Returns:
- true if a value transformer is in use
- Since:
- 3.1
 
- 
putDescription copied from interface:PutAssociates the specified value with the specified key in this map.Note that the return type is Object, rather than V as in the Map interface. See the class Javadoc for further info. - Specified by:
- putin interface- Map<K,- V> 
- Specified by:
- putin interface- Put<K,- V> 
- Overrides:
- putin class- AbstractMapDecorator<K,- V> 
- Parameters:
- key- key with which the specified value is to be associated
- value- value to be associated with the specified key
- Returns:
- the previous value associated with key, ornullif there was no mapping forkey. (Anullreturn can also indicate that the map previously associatednullwithkey, if the implementation supportsnullvalues.)
- See Also:
 
- 
putAllDescription copied from interface:PutCopies all of the mappings from the specified map to this map.
- 
transformKeyTransforms a key.The transformer itself may throw an exception if necessary. - Parameters:
- object- the object to transform
- Returns:
- the transformed object
 
- 
transformMap
- 
transformValueTransforms a value.The transformer itself may throw an exception if necessary. - Parameters:
- object- the object to transform
- Returns:
- the transformed object
 
- 
entrySetDescription copied from interface:GetGets a set view of the mappings contained in this map.
 
-