@GwtCompatible(serializable=true, emulated=true) public class ImmutableSetMultimap<K,V> extends ImmutableMultimap<K,V> implements SetMultimap<K,V>
SetMultimap whose contents will never change, with many other important properties
detailed at ImmutableCollection.
See the Guava User Guide article on immutable collections.
| Modifier and Type | Class and Description |
|---|---|
static class |
ImmutableSetMultimap.Builder<K,V>
A builder for creating immutable
SetMultimap instances, especially public static
final multimaps ("constant multimaps"). |
| Modifier and Type | Method and Description |
|---|---|
static <K,V> ImmutableSetMultimap.Builder<K,V> |
builder()
Returns a new
ImmutableSetMultimap.Builder. |
boolean |
containsEntry(@Nullable Object key,
@Nullable Object value)
Returns
true if this multimap contains at least one key-value pair with the key key and the value value. |
static <K,V> ImmutableSetMultimap<K,V> |
copyOf(Iterable<? extends Map.Entry<? extends K,? extends V>> entries)
Returns an immutable multimap containing the specified entries.
|
static <K,V> ImmutableSetMultimap<K,V> |
copyOf(Multimap<? extends K,? extends V> multimap)
Returns an immutable set multimap containing the same mappings as
multimap. |
ImmutableSet<Map.Entry<K,V>> |
entries()
Returns an immutable collection of all key-value pairs in the multimap.
|
boolean |
equals(@Nullable Object object)
Indicates whether some other object is "equal to" this one.
|
static <T,K,V> Collector<T,?,ImmutableSetMultimap<K,V>> |
flatteningToImmutableSetMultimap(Function<? super T,? extends K> keyFunction,
Function<? super T,? extends Stream<? extends V>> valuesFunction)
Returns a
Collector accumulating entries into an ImmutableSetMultimap. |
ImmutableSet<V> |
get(K key)
Returns an immutable set of the values for the given key.
|
int |
hashCode()
Returns the hash code for this multimap.
|
ImmutableSetMultimap<V,K> |
inverse()
Returns an immutable multimap which is the inverse of this one.
|
boolean |
isEmpty()
Returns
true if this multimap contains no key-value pairs. |
static <K,V> ImmutableSetMultimap<K,V> |
of()
Returns the empty multimap.
|
static <K,V> ImmutableSetMultimap<K,V> |
of(K k1,
V v1)
Returns an immutable multimap containing a single entry.
|
static <K,V> ImmutableSetMultimap<K,V> |
of(K k1,
V v1,
K k2,
V v2)
Returns an immutable multimap containing the given entries, in order.
|
static <K,V> ImmutableSetMultimap<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> ImmutableSetMultimap<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> ImmutableSetMultimap<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.
|
ImmutableSet<V> |
removeAll(Object key)
Deprecated.
Unsupported operation.
|
ImmutableSet<V> |
replaceValues(K key,
Iterable<? extends V> values)
Deprecated.
Unsupported operation.
|
static <T,K,V> Collector<T,?,ImmutableSetMultimap<K,V>> |
toImmutableSetMultimap(Function<? super T,? extends K> keyFunction,
Function<? super T,? extends V> valueFunction)
Returns a
Collector that accumulates elements into an ImmutableSetMultimap
whose keys and values are the result of applying the provided mapping functions to the input
elements. |
String |
toString()
Returns a string representation of the multimap, generated by calling
toString on the
map returned by Multimap.asMap(). |
asMap, clear, containsKey, containsValue, forEach, keys, keySet, put, putAll, putAll, remove, size, valuesclone, finalize, getClass, notify, notifyAll, wait, wait, waitasMap, equals@Beta public static <T,K,V> Collector<T,?,ImmutableSetMultimap<K,V>> toImmutableSetMultimap(Function<? super T,? extends K> keyFunction, Function<? super T,? extends V> valueFunction)
Collector that accumulates elements into an ImmutableSetMultimap
whose keys and values are the result of applying the provided mapping functions to the input
elements.
For streams with defined encounter order, that order is preserved, but entries are grouped by key.
Example:
static final Multimap<Character, String> FIRST_LETTER_MULTIMAP =
Stream.of("banana", "apple", "carrot", "asparagus", "cherry")
.collect(toImmutableSetMultimap(str -> str.charAt(0), str -> str.substring(1)));
// is equivalent to
static final Multimap<Character, String> FIRST_LETTER_MULTIMAP =
new ImmutableSetMultimap.Builder<Character, String>()
.put('b', "anana")
.putAll('a', "pple", "sparagus")
.putAll('c', "arrot", "herry")
.build();
@Beta public static <T,K,V> Collector<T,?,ImmutableSetMultimap<K,V>> flatteningToImmutableSetMultimap(Function<? super T,? extends K> keyFunction, Function<? super T,? extends Stream<? extends V>> valuesFunction)
Collector accumulating entries into an ImmutableSetMultimap. Each
input element is mapped to a key and a stream of values, each of which are put into the
resulting Multimap, in the encounter order of the stream and the encounter order of the
streams of values.
Example:
static final ImmutableSetMultimap<Character, Character> FIRST_LETTER_MULTIMAP =
Stream.of("banana", "apple", "carrot", "asparagus", "cherry")
.collect(
flatteningToImmutableSetMultimap(
str -> str.charAt(0),
str -> str.substring(1).chars().mapToObj(c -> (char) c));
// is equivalent to
static final ImmutableSetMultimap<Character, Character> FIRST_LETTER_MULTIMAP =
ImmutableSetMultimap.<Character, Character>builder()
.putAll('b', Arrays.asList('a', 'n', 'a', 'n', 'a'))
.putAll('a', Arrays.asList('p', 'p', 'l', 'e'))
.putAll('c', Arrays.asList('a', 'r', 'r', 'o', 't'))
.putAll('a', Arrays.asList('s', 'p', 'a', 'r', 'a', 'g', 'u', 's'))
.putAll('c', Arrays.asList('h', 'e', 'r', 'r', 'y'))
.build();
// after deduplication, the resulting multimap is equivalent to
static final ImmutableSetMultimap<Character, Character> FIRST_LETTER_MULTIMAP =
ImmutableSetMultimap.<Character, Character>builder()
.putAll('b', Arrays.asList('a', 'n'))
.putAll('a', Arrays.asList('p', 'l', 'e', 's', 'a', 'r', 'g', 'u'))
.putAll('c', Arrays.asList('a', 'r', 'o', 't', 'h', 'e', 'y'))
.build();
}public static <K,V> ImmutableSetMultimap<K,V> of()
public static <K,V> ImmutableSetMultimap<K,V> of(K k1, V v1)
public static <K,V> ImmutableSetMultimap<K,V> of(K k1, V v1, K k2, V v2)
Object.equals(java.lang.Object)) after the first are ignored.public static <K,V> ImmutableSetMultimap<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3)
Object.equals(java.lang.Object)) after the first are ignored.public static <K,V> ImmutableSetMultimap<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)
Object.equals(java.lang.Object)) after the first are ignored.public static <K,V> ImmutableSetMultimap<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5)
Object.equals(java.lang.Object)) after the first are ignored.public static <K,V> ImmutableSetMultimap.Builder<K,V> builder()
ImmutableSetMultimap.Builder.public static <K,V> ImmutableSetMultimap<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. Repeated occurrences of an entry in the multimap after the first are
ignored.
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.
NullPointerException - if any key or value in multimap is null@Beta public static <K,V> ImmutableSetMultimap<K,V> copyOf(Iterable<? extends Map.Entry<? extends K,? extends V>> entries)
NullPointerException - if any key, value, or entry is nullpublic ImmutableSet<V> get(K key)
public ImmutableSetMultimap<V,K> inverse()
Because an inverse of a set multimap cannot contain multiple pairs with the same key and
value, this method returns an ImmutableSetMultimap rather than the ImmutableMultimap specified in the ImmutableMultimap class.
inverse in class ImmutableMultimap<K,V>@CanIgnoreReturnValue @Deprecated public ImmutableSet<V> removeAll(Object key)
removeAll in interface Multimap<K,V>removeAll in interface SetMultimap<K,V>removeAll in class ImmutableMultimap<K,V>UnsupportedOperationException - always@CanIgnoreReturnValue @Deprecated public ImmutableSet<V> replaceValues(K key, Iterable<? extends V> values)
replaceValues in interface Multimap<K,V>replaceValues in interface SetMultimap<K,V>replaceValues in class ImmutableMultimap<K,V>UnsupportedOperationException - alwayspublic ImmutableSet<Map.Entry<K,V>> entries()
public boolean isEmpty()
Multimaptrue if this multimap contains no key-value pairs. Equivalent to size()
== 0, but can in some cases be more efficient.public boolean containsEntry(@Nullable Object key, @Nullable Object value)
Multimaptrue if this multimap contains at least one key-value pair with the key key and the value value.containsEntry in interface Multimap<K,V>public boolean equals(@Nullable Object object)
java.lang.Object
The equals method implements an equivalence relation
on non-null object references:
x, x.equals(x) should return
true.
x and y, x.equals(y)
should return true if and only if
y.equals(x) returns true.
x, y, and z, if
x.equals(y) returns true and
y.equals(z) returns true, then
x.equals(z) should return true.
x and y, multiple invocations of
x.equals(y) consistently return true
or consistently return false, provided no
information used in equals comparisons on the
objects is modified.
x,
x.equals(null) should return false.
The equals method for class Object implements
the most discriminating possible equivalence relation on objects;
that is, for any non-null reference values x and
y, this method returns true if and only
if x and y refer to the same object
(x == y has the value true).
Note that it is generally necessary to override the hashCode
method whenever this method is overridden, so as to maintain the
general contract for the hashCode method, which states
that equal objects must have equal hash codes.
public int hashCode()
The hash code of a multimap is defined as the hash code of the map view, as returned by
Multimap.asMap().
hashCode in interface Multimap<K,V>hashCode in class ObjectMap.hashCode()public String toString()
toString on the
map returned by Multimap.asMap().Copyright © 2010–2018. All rights reserved.