public final class UnmodifiableBidiMap extends AbstractBidiMapDecorator implements Unmodifiable
BidiMap
to ensure it can't be altered.map
Modifier and Type | Method and Description |
---|---|
void |
clear() |
static BidiMap |
decorate(BidiMap map)
Factory method to create an unmodifiable map.
|
Set |
entrySet() |
BidiMap |
inverseBidiMap()
Gets a view of this map where the keys and values are reversed.
|
Set |
keySet() |
MapIterator |
mapIterator()
Obtains a
MapIterator over the map. |
Object |
put(Object key,
Object value)
Puts the key-value pair into the map, replacing any previous pair.
|
void |
putAll(Map mapToCopy) |
Object |
remove(Object key) |
Object |
removeValue(Object value)
Removes the key-value pair that is currently mapped to the specified
value (optional operation).
|
Collection |
values() |
getBidiMap, getKey
containsKey, containsValue, equals, get, getMap, hashCode, isEmpty, size, toString
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
containsKey, containsValue, equals, get, hashCode, isEmpty, size
public static BidiMap decorate(BidiMap map)
If the map passed in is already unmodifiable, it is returned.
map
- the map to decorate, must not be nullIllegalArgumentException
- if map is nullpublic void clear()
clear
in interface Map
clear
in class AbstractMapDecorator
public Object put(Object key, Object value)
BidiMap
When adding a key-value pair, the value may already exist in the map against a different key. That mapping is removed, to ensure that the value only occurs once in the inverse map.
BidiMap map1 = new DualHashBidiMap(); map.put("A","B"); // contains A mapped to B, as per Map map.put("A","C"); // contains A mapped to C, as per Map BidiMap map2 = new DualHashBidiMap(); map.put("A","B"); // contains A mapped to B, as per Map map.put("C","B"); // contains C mapped to B, key A is removed
public void putAll(Map mapToCopy)
putAll
in interface Map
putAll
in class AbstractMapDecorator
public Object remove(Object key)
remove
in interface Map
remove
in class AbstractMapDecorator
public Set entrySet()
entrySet
in interface Map
entrySet
in class AbstractMapDecorator
public Set keySet()
keySet
in interface Map
keySet
in class AbstractMapDecorator
public Collection values()
values
in interface Map
values
in class AbstractMapDecorator
public Object removeValue(Object value)
BidiMap
If the value is not contained in the map, null
is returned.
Implementations should seek to make this method perform equally as well
as remove(Object)
.
removeValue
in interface BidiMap
removeValue
in class AbstractBidiMapDecorator
value
- the value to find the key-value pair fornull
if nothing removedpublic MapIterator mapIterator()
BidiMap
MapIterator
over the map.
A map iterator is an efficient way of iterating over maps. It does not require that the map is stored using Map Entry objects which can increase performance.
BidiMap map = new DualHashBidiMap(); MapIterator it = map.mapIterator(); while (it.hasNext()) { Object key = it.next(); Object value = it.getValue(); it.setValue("newValue"); }
mapIterator
in interface BidiMap
mapIterator
in interface IterableMap
mapIterator
in class AbstractBidiMapDecorator
public BidiMap inverseBidiMap()
BidiMap
Changes to one map will be visible in the other and vice versa.
This enables both directions of the map to be accessed as a Map
.
Implementations should seek to avoid creating a new object every time this
method is called. See AbstractMap.values()
etc. Calling this
method on the inverse map should return the original.
inverseBidiMap
in interface BidiMap
inverseBidiMap
in class AbstractBidiMapDecorator
Copyright © 2001–2015 The Apache Software Foundation. All rights reserved.