java.lang.Object
- com.google.common.collect.ImmutableMap<K,V>

All Implemented Interfaces:

java.io.Serializable, java.util.Map<K,V>

Direct Known Subclasses:

ImmutableBiMap, ImmutableSortedMap
```
@DoNotMock("Use ImmutableMap.of or another implementation")
@GwtCompatible(serializable=true,
               emulated=true)
public abstract class ImmutableMap<K,V>
extends java.lang.Object
implements java.util.Map<K,V>, java.io.Serializable
```
A Map whose contents will never change, with many other important properties detailed at ImmutableCollection.
See the Guava User Guide article on immutable collections.

Since:

2.0

Author:

Jesse Wilson, Kevin Bourrillion

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`static class`	`ImmutableMap.Builder<K,V>`	A builder for creating immutable map instances, especially `public static final` maps ("constant maps").

Nested classes/interfaces inherited from interface java.util.Map
java.util.Map.Entry<K extends java.lang.Object,V extends java.lang.Object>

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`ImmutableSetMultimap<K,V>`	`asMultimap()`	Returns a multimap view of the map.
`static <K,V> ImmutableMap.Builder<K,V>`	`builder()`	Returns a new builder.
`static <K,V> ImmutableMap.Builder<K,V>`	`builderWithExpectedSize(int expectedSize)`	Returns a new builder, expecting the specified number of entries to be added.
`void`	`clear()`	Deprecated. Unsupported operation.
`boolean`	`containsKey(java.lang.Object key)`
`boolean`	`containsValue(java.lang.Object value)`
`static <K,V> ImmutableMap<K,V>`	`copyOf(java.lang.Iterable<? extends java.util.Map.Entry<? extends K,? extends V>> entries)`	Returns an immutable map containing the specified entries.
`static <K,V> ImmutableMap<K,V>`	`copyOf(java.util.Map<? extends K,? extends V> map)`	Returns an immutable map containing the same entries as `map`.
`ImmutableSet<java.util.Map.Entry<K,V>>`	`entrySet()`	Returns an immutable set of the mappings in this map.
`boolean`	`equals(java.lang.Object object)`
`abstract V`	`get(java.lang.Object key)`
`V`	`getOrDefault(java.lang.Object key, V defaultValue)`
`int`	`hashCode()`
`boolean`	`isEmpty()`
`ImmutableSet<K>`	`keySet()`	Returns an immutable set of the keys in this map, in the same order that they appear in `entrySet`.
`static <K,V> ImmutableMap<K,V>`	`of()`	Returns the empty map.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1)`	Returns an immutable map containing a single entry.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9, K k10, V v10)`	Returns an immutable map containing the given entries, in order.
`static <K,V> ImmutableMap<K,V>`	`ofEntries(java.util.Map.Entry<? extends K,? extends V>... entries)`	Returns an immutable map containing the given entries, in order.
`V`	`put(K k, V v)`	Deprecated. Unsupported operation.
`void`	`putAll(java.util.Map<? extends K,? extends V> map)`	Deprecated. Unsupported operation.
`V`	`remove(java.lang.Object o)`	Deprecated. Unsupported operation.
`java.lang.String`	`toString()`
`ImmutableCollection<V>`	`values()`	Returns an immutable collection of the values in this map, in the same order that they appear in `entrySet`.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, merge, putIfAbsent, remove, replace, replace, replaceAll, size

Method Detail

of
```
public static <K,V> ImmutableMap<K,V> of()
```
Returns the empty map. This map behaves and performs comparably to Collections.emptyMap(), and is preferable mainly for consistency and maintainability of your code.
Performance note: the instance returned is a singleton.

of
```
public static <K,V> ImmutableMap<K,V> of(K k1,
                                                     V v1)
```
Returns an immutable map containing a single entry. This map behaves and performs comparably to Collections.singletonMap(K, V) but will not accept a null key or value. It is preferable mainly for consistency and maintainability of your code.