Package com.google.common.collect
Class EnumHashBiMap<K extends Enum<K>,V>
- java.lang.Object
-
- com.google.common.collect.ForwardingObject
-
- com.google.common.collect.ForwardingMap<K,V>
-
- com.google.common.collect.EnumHashBiMap<K,V>
-
- All Implemented Interfaces:
BiMap<K,V>,Serializable,Map<K,V>
@GwtCompatible(emulated=true) public final class EnumHashBiMap<K extends Enum<K>,V> extends ForwardingMap<K,V>
ABiMapbacked by anEnumMapinstance for keys-to-values, and aHashMapinstance for values-to-keys. Null keys are not permitted, but null values are. AnEnumHashBiMapand its inverse are both serializable.See the Guava User Guide article on
BiMap.- Since:
- 2.0 (imported from Google Collections Library)
- See Also:
- Serialized Form
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclear()booleancontainsValue(Object value)static <K extends Enum<K>,V>
EnumHashBiMap<K,V>create(Class<K> keyType)Returns a new, emptyEnumHashBiMapusing the specified key type.static <K extends Enum<K>,V>
EnumHashBiMap<K,V>create(Map<K,? extends V> map)Constructs a new bimap with the same mappings as the specified map.Set<Map.Entry<K,V>>entrySet()VforcePut(K key, V value)An alternate form ofputthat silently removes any existing entry with the valuevaluebefore proceeding with theBiMap.put(K, V)operation.BiMap<V,K>inverse()Returns the inverse view of this bimap, which maps each of this bimap's values to its associated key.Set<K>keySet()Class<K>keyType()Returns the associated key type.Vput(K key, V value)voidputAll(Map<? extends K,? extends V> map)Vremove(Object key)Set<V>values()-
Methods inherited from class com.google.common.collect.ForwardingMap
containsKey, equals, get, hashCode, isEmpty, size
-
Methods inherited from class com.google.common.collect.ForwardingObject
toString
-
Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, containsKey, equals, forEach, get, getOrDefault, hashCode, isEmpty, merge, putIfAbsent, remove, replace, replace, replaceAll, size
-
-
-
-
Method Detail
-
create
public static <K extends Enum<K>,V> EnumHashBiMap<K,V> create(Class<K> keyType)
Returns a new, emptyEnumHashBiMapusing the specified key type.- Parameters:
keyType- the key type
-
create
public static <K extends Enum<K>,V> EnumHashBiMap<K,V> create(Map<K,? extends V> map)
Constructs a new bimap with the same mappings as the specified map. If the specified map is anEnumHashBiMapor anEnumBiMap, the new bimap has the same key type as the input bimap. Otherwise, the specified map must contain at least one mapping, in order to determine the key type.- Parameters:
map- the map whose mappings are to be placed in this map- Throws:
IllegalArgumentException- if map is not anEnumBiMapor anEnumHashBiMapinstance and contains no mappings
-
forcePut
public V forcePut(K key, @Nullable V value)
Description copied from interface:BiMapAn alternate form ofputthat silently removes any existing entry with the valuevaluebefore proceeding with theBiMap.put(K, V)operation. If the bimap previously contained the provided key-value mapping, this method has no effect.Note that a successful call to this method could cause the size of the bimap to increase by one, stay the same, or even decrease by one.
Warning: If an existing entry with this value is removed, the key for that entry is discarded and not returned.
- Specified by:
forcePutin interfaceBiMap<K extends Enum<K>,V>- Parameters:
key- the key with which the specified value is to be associatedvalue- the value to be associated with the specified key- Returns:
- the value which was previously associated with the key, which may
be
null, ornullif there was no previous entry
-
containsValue
public boolean containsValue(@Nullable Object value)
- Specified by:
containsValuein interfaceMap<K,V>- Overrides:
containsValuein classForwardingMap<K,V>
-
remove
public V remove(@Nullable Object key)
- Specified by:
removein interfaceMap<K,V>- Overrides:
removein classForwardingMap<K,V>
-
putAll
public void putAll(Map<? extends K,? extends V> map)
Description copied from interface:BiMapWarning: the results of calling this method may vary depending on the iteration order of
map.
-
clear
public void clear()
- Specified by:
clearin interfaceMap<K,V>- Overrides:
clearin classForwardingMap<K,V>
-
inverse
public BiMap<V,K> inverse()
Description copied from interface:BiMapReturns the inverse view of this bimap, which maps each of this bimap's values to its associated key. The two bimaps are backed by the same data; any changes to one will appear in the other.Note:There is no guaranteed correspondence between the iteration order of a bimap and that of its inverse.
-
keySet
public Set<K> keySet()
- Specified by:
keySetin interfaceMap<K,V>- Overrides:
keySetin classForwardingMap<K,V>
-
values
public Set<V> values()
Description copied from interface:BiMapBecause a bimap has unique values, this method returns a
Set, instead of theCollectionspecified in theMapinterface.
-
-