org.apache.commons.collections.map
Class TransformedSortedMap
java.lang.Object
org.apache.commons.collections.map.AbstractMapDecorator
org.apache.commons.collections.map.AbstractInputCheckedMapDecorator
org.apache.commons.collections.map.TransformedMap
org.apache.commons.collections.map.TransformedSortedMap
- All Implemented Interfaces:
- java.util.Map, java.io.Serializable, java.util.SortedMap
- public class TransformedSortedMap
- extends TransformedMap
- implements java.util.SortedMap
Decorates another SortedMap
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.
This class is Serializable from Commons Collections 3.1.
- Since:
- Commons Collections 3.0
- Version:
- $Revision: 1.6 $ $Date: 2004/04/09 10:36:01 $
- Author:
- Stephen Colebourne
- See Also:
- Serialized Form
Nested classes inherited from class java.util.Map |
java.util.Map.Entry |
Method Summary |
java.util.Comparator |
comparator()
|
static java.util.SortedMap |
decorate(java.util.SortedMap map,
Transformer keyTransformer,
Transformer valueTransformer)
Factory method to create a transforming sorted map. |
java.lang.Object |
firstKey()
|
protected java.util.SortedMap |
getSortedMap()
Gets the map being decorated. |
java.util.SortedMap |
headMap(java.lang.Object toKey)
|
java.lang.Object |
lastKey()
|
java.util.SortedMap |
subMap(java.lang.Object fromKey,
java.lang.Object toKey)
|
java.util.SortedMap |
tailMap(java.lang.Object fromKey)
|
Methods inherited from class org.apache.commons.collections.map.AbstractMapDecorator |
clear, containsKey, containsValue, equals, get, getMap, hashCode, isEmpty, keySet, remove, size, toString, values |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.util.Map |
clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values |
TransformedSortedMap
protected TransformedSortedMap(java.util.SortedMap map,
Transformer keyTransformer,
Transformer 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 nullkeyTransformer
- the predicate to validate the keys, null means no transformationvalueTransformer
- the predicate to validate to values, null means no transformation
- Throws:
java.lang.IllegalArgumentException
- if the map is null
decorate
public static java.util.SortedMap decorate(java.util.SortedMap map,
Transformer keyTransformer,
Transformer valueTransformer)
- Factory method to create a transforming sorted map.
If there are any elements already in the map being decorated, they
are NOT transformed.
- Parameters:
map
- the map to decorate, must not be nullkeyTransformer
- the predicate to validate the keys, null means no transformationvalueTransformer
- the predicate to validate to values, null means no transformation
- Throws:
java.lang.IllegalArgumentException
- if the map is null
getSortedMap
protected java.util.SortedMap getSortedMap()
- Gets the map being decorated.
- Returns:
- the decorated map
firstKey
public java.lang.Object firstKey()
- Specified by:
firstKey
in interface java.util.SortedMap
lastKey
public java.lang.Object lastKey()
- Specified by:
lastKey
in interface java.util.SortedMap
comparator
public java.util.Comparator comparator()
- Specified by:
comparator
in interface java.util.SortedMap
subMap
public java.util.SortedMap subMap(java.lang.Object fromKey,
java.lang.Object toKey)
- Specified by:
subMap
in interface java.util.SortedMap
headMap
public java.util.SortedMap headMap(java.lang.Object toKey)
- Specified by:
headMap
in interface java.util.SortedMap
tailMap
public java.util.SortedMap tailMap(java.lang.Object fromKey)
- Specified by:
tailMap
in interface java.util.SortedMap
Copyright © 2001-2005 Apache Software Foundation. All Rights Reserved.