@GwtCompatible(emulated=true) public abstract class ImmutableMultimap<K,V> extends AbstractMultimap<K,V> implements java.io.Serializable
Multimap
. Does not permit null keys or values.
Unlike Multimaps.unmodifiableMultimap(Multimap)
, which is
a view of a separate multimap which can still change, an instance of
ImmutableMultimap
contains its own data and will never
change. ImmutableMultimap
is convenient for
public static final
multimaps ("constant multimaps") and also lets
you easily make a "defensive copy" of a multimap provided to your class by
a caller.
Note: Although this class is not final, it cannot be subclassed as it has no public or protected constructors. Thus, instances of this class are guaranteed to be immutable.
In addition to methods defined by Multimap
, an inverse()
method is also supported.
See the Guava User Guide article on immutable collections.
Modifier and Type | Class and Description |
---|---|
static class |
ImmutableMultimap.Builder<K,V>
A builder for creating immutable multimap instances, especially
public static final multimaps ("constant multimaps"). |
private static class |
ImmutableMultimap.BuilderMultimap<K,V>
Multimap for
ImmutableMultimap.Builder that maintains key and
value orderings, allows duplicate values, and performs better than
LinkedListMultimap . |
private static class |
ImmutableMultimap.EntryCollection<K,V> |
(package private) static class |
ImmutableMultimap.FieldSettersHolder |
private class |
ImmutableMultimap.Itr<T> |
(package private) class |
ImmutableMultimap.Keys |
private static class |
ImmutableMultimap.Values<K,V> |
Modifier and Type | Field and Description |
---|---|
(package private) ImmutableMap<K,? extends ImmutableCollection<V>> |
map |
private static long |
serialVersionUID |
(package private) int |
size |
Constructor and Description |
---|
ImmutableMultimap(ImmutableMap<K,? extends ImmutableCollection<V>> map,
int size) |
Modifier and Type | Method and Description |
---|---|
ImmutableMap<K,java.util.Collection<V>> |
asMap()
Returns an immutable map that associates each key with its corresponding
values in the multimap.
|
static <K,V> ImmutableMultimap.Builder<K,V> |
builder()
Returns a new builder.
|
void |
clear()
Deprecated.
Unsupported operation.
|
boolean |
containsKey(java.lang.Object key)
Returns
true if this multimap contains at least one key-value pair
with the key key . |
boolean |
containsValue(java.lang.Object value)
Returns
true if this multimap contains at least one key-value pair
with the value value . |
static <K,V> ImmutableMultimap<K,V> |
copyOf(Multimap<? extends K,? extends V> multimap)
Returns an immutable multimap containing the same mappings as
multimap . |
(package private) java.util.Map<K,java.util.Collection<V>> |
createAsMap() |
(package private) ImmutableCollection<java.util.Map.Entry<K,V>> |
createEntries() |
(package private) ImmutableMultiset<K> |
createKeys() |
(package private) ImmutableCollection<V> |
createValues() |
ImmutableCollection<java.util.Map.Entry<K,V>> |
entries()
Returns an immutable collection of all key-value pairs in the multimap.
|
(package private) UnmodifiableIterator<java.util.Map.Entry<K,V>> |
entryIterator() |
abstract ImmutableCollection<V> |
get(K key)
Returns an immutable collection of the values for the given key.
|
abstract ImmutableMultimap<V,K> |
inverse()
Returns an immutable multimap which is the inverse of this one.
|
(package private) boolean |
isPartialView()
Returns
true if this immutable multimap's implementation contains references to
user-created objects that aren't accessible via this multimap's methods. |
ImmutableMultiset<K> |
keys()
Returns a collection, which may contain duplicates, of all keys.
|
ImmutableSet<K> |
keySet()
Returns an immutable set of the distinct keys in this multimap.
|
static <K,V> ImmutableMultimap<K,V> |
of()
Returns an empty multimap.
|
static <K,V> ImmutableMultimap<K,V> |
of(K k1,
V v1)
Returns an immutable multimap containing a single entry.
|
static <K,V> ImmutableMultimap<K,V> |
of(K k1,
V v1,
K k2,
V v2)
Returns an immutable multimap containing the given entries, in order.
|
static <K,V> ImmutableMultimap<K,V> |
of(K k1,
V v1,
K k2,
V v2,
K k3,
V v3)
Returns an immutable multimap containing the given entries, in order.
|
static <K,V> ImmutableMultimap<K,V> |
of(K k1,
V v1,
K k2,
V v2,
K k3,
V v3,
K k4,
V v4)
Returns an immutable multimap containing the given entries, in order.
|
static <K,V> ImmutableMultimap<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 multimap containing the given entries, in order.
|
boolean |
put(K key,
V value)
Deprecated.
Unsupported operation.
|
boolean |
putAll(K key,
java.lang.Iterable<? extends V> values)
Deprecated.
Unsupported operation.
|
boolean |
putAll(Multimap<? extends K,? extends V> multimap)
Deprecated.
Unsupported operation.
|
boolean |
remove(java.lang.Object key,
java.lang.Object value)
Deprecated.
Unsupported operation.
|
ImmutableCollection<V> |
removeAll(java.lang.Object key)
Deprecated.
Unsupported operation.
|
ImmutableCollection<V> |
replaceValues(K key,
java.lang.Iterable<? extends V> values)
Deprecated.
Unsupported operation.
|
int |
size()
Returns the number of key-value pairs in this multimap.
|
(package private) UnmodifiableIterator<V> |
valueIterator() |
ImmutableCollection<V> |
values()
Returns an immutable collection of the values in this multimap.
|
containsEntry, createKeySet, equals, hashCode, isEmpty, toString
final transient ImmutableMap<K,? extends ImmutableCollection<V>> map
final transient int size
private static final long serialVersionUID
ImmutableMultimap(ImmutableMap<K,? extends ImmutableCollection<V>> map, int size)
public static <K,V> ImmutableMultimap<K,V> of()
public static <K,V> ImmutableMultimap<K,V> of(K k1, V v1)
public static <K,V> ImmutableMultimap<K,V> of(K k1, V v1, K k2, V v2)
public static <K,V> ImmutableMultimap<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3)
public static <K,V> ImmutableMultimap<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)
public static <K,V> ImmutableMultimap<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5)
public static <K,V> ImmutableMultimap.Builder<K,V> builder()
ImmutableMultimap.Builder
constructor.public static <K,V> ImmutableMultimap<K,V> copyOf(Multimap<? extends K,? extends V> multimap)
multimap
. The generated multimap's key and value orderings correspond to
the iteration ordering of the multimap.asMap()
view.
Despite the method name, this method attempts to avoid actually copying the data when it is safe to do so. The exact circumstances under which a copy will or will not be performed are undocumented and subject to change.
java.lang.NullPointerException
- if any key or value in multimap
is
null@Deprecated public ImmutableCollection<V> removeAll(java.lang.Object key)
@Deprecated public ImmutableCollection<V> replaceValues(K key, java.lang.Iterable<? extends V> values)
replaceValues
in interface Multimap<K,V>
replaceValues
in class AbstractMultimap<K,V>
java.lang.UnsupportedOperationException
- always@Deprecated public void clear()
public abstract ImmutableCollection<V> get(K key)
public abstract ImmutableMultimap<V,K> inverse()
@Deprecated public boolean put(K key, V value)
put
in interface Multimap<K,V>
put
in class AbstractMultimap<K,V>
true
if the method increased the size of the multimap, or
false
if the multimap already contained the key-value pair and
doesn't allow duplicatesjava.lang.UnsupportedOperationException
- always@Deprecated public boolean putAll(K key, java.lang.Iterable<? extends V> values)
@Deprecated public boolean putAll(Multimap<? extends K,? extends V> multimap)
@Deprecated public boolean remove(java.lang.Object key, java.lang.Object value)
boolean isPartialView()
true
if this immutable multimap's implementation contains references to
user-created objects that aren't accessible via this multimap's methods. This is generally
used to determine whether copyOf
implementations should make an explicit copy to avoid
memory leaks.public boolean containsKey(@Nullable java.lang.Object key)
Multimap
true
if this multimap contains at least one key-value pair
with the key key
.containsKey
in interface Multimap<K,V>
public boolean containsValue(@Nullable java.lang.Object value)
Multimap
true
if this multimap contains at least one key-value pair
with the value value
.containsValue
in interface Multimap<K,V>
containsValue
in class AbstractMultimap<K,V>
public int size()
Multimap
Note: this method does not return the number of distinct
keys in the multimap, which is given by keySet().size()
or
asMap().size()
. See the opening section of the Multimap
class documentation for clarification.
public ImmutableSet<K> keySet()
public ImmutableMap<K,java.util.Collection<V>> asMap()
java.util.Map<K,java.util.Collection<V>> createAsMap()
createAsMap
in class AbstractMultimap<K,V>
public ImmutableCollection<java.util.Map.Entry<K,V>> entries()
ImmutableCollection<java.util.Map.Entry<K,V>> createEntries()
createEntries
in class AbstractMultimap<K,V>
UnmodifiableIterator<java.util.Map.Entry<K,V>> entryIterator()
entryIterator
in class AbstractMultimap<K,V>
public ImmutableMultiset<K> keys()
ImmutableMultiset<K> createKeys()
createKeys
in class AbstractMultimap<K,V>
public ImmutableCollection<V> values()
ImmutableCollection<V> createValues()
createValues
in class AbstractMultimap<K,V>
UnmodifiableIterator<V> valueIterator()
valueIterator
in class AbstractMultimap<K,V>