Package com.google.common.collect

Class ImmutableMultimap.Builder<K,V>

java.lang.Object

com.google.common.collect.ImmutableMultimap.Builder<K,V>

Direct Known Subclasses:

ImmutableListMultimap.Builder, ImmutableSetMultimap.Builder

Enclosing class:

ImmutableMultimap<K,V>

@DoNotMock
public static class ImmutableMultimap.Builder<K,V>
extends Object

A builder for creating immutable multimap instances, especially public static final multimaps ("constant multimaps"). Example:

 static final Multimap<String, Integer> STRING_TO_INTEGER_MULTIMAP =
     new ImmutableMultimap.Builder<String, Integer>()
         .put("one", 1)
         .putAll("several", 1, 2, 3)
         .putAll("many", 1, 2, 3, 4, 5)
         .build();
 

Builder instances can be reused; it is safe to call build() multiple times to build multiple multimaps in series. Each multimap contains the key-value mappings in the previously created multimaps.

Since:

2.0

Constructor Summary

Constructors

Constructor	Description
Builder()	Creates a new builder.

Method Summary

Modifier and Type	Method	Description
ImmutableMultimap<K,V>	build()	Returns a newly-created immutable multimap.
ImmutableMultimap.Builder<K,V>	orderKeysBy(Comparator<? super K> keyComparator)	Specifies the ordering of the generated multimap's keys.
ImmutableMultimap.Builder<K,V>	orderValuesBy(Comparator<? super V> valueComparator)	Specifies the ordering of the generated multimap's values for each key.
ImmutableMultimap.Builder<K,V>	put(Map.Entry<? extends K,? extends V> entry)	Adds an entry to the built multimap.
ImmutableMultimap.Builder<K,V>	put(K key, V value)	Adds a key-value mapping to the built multimap.
ImmutableMultimap.Builder<K,V>	putAll(Multimap<? extends K,? extends V> multimap)	Stores another multimap's entries in the built multimap.
ImmutableMultimap.Builder<K,V>	putAll(Iterable<? extends Map.Entry<? extends K,? extends V>> entries)	Adds entries to the built multimap.
ImmutableMultimap.Builder<K,V>	putAll(K key, Iterable<? extends V> values)	Stores a collection of values with the same key in the built multimap.
ImmutableMultimap.Builder<K,V>	putAll(K key, V... values)	Stores an array of values with the same key in the built multimap.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Creates a new builder. The returned builder is equivalent to the builder generated by ImmutableMultimap.builder().

Method Detail

put

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> put(K key,
                                                V value)

Adds a key-value mapping to the built multimap.

put

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> put(Map.Entry<? extends K,? extends V> entry)

Adds an entry to the built multimap.

Since:

11.0

putAll

@CanIgnoreReturnValue
@Beta
public ImmutableMultimap.Builder<K,V> putAll(Iterable<? extends Map.Entry<? extends K,? extends V>> entries)

Adds entries to the built multimap.

Since:

19.0

putAll

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> putAll(K key,
                                                   Iterable<? extends V> values)

Stores a collection of values with the same key in the built multimap.

Throws:

NullPointerException - if key, values, or any element in values is null. The builder is left in an invalid state.

putAll

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> putAll(K key,
                                                   V... values)

Stores an array of values with the same key in the built multimap.

Throws:

NullPointerException - if the key or any value is null. The builder is left in an invalid state.

putAll

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> putAll(Multimap<? extends K,? extends V> multimap)

Stores another multimap's entries in the built multimap. The generated multimap's key and value orderings correspond to the iteration ordering of the multimap.asMap() view, with new keys and values following any existing keys and values.

Throws:

NullPointerException - if any key or value in multimap is null. The builder is left in an invalid state.

orderKeysBy

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> orderKeysBy(Comparator<? super K> keyComparator)

Specifies the ordering of the generated multimap's keys.

Since:

8.0

orderValuesBy

@CanIgnoreReturnValue
public ImmutableMultimap.Builder<K,V> orderValuesBy(Comparator<? super V> valueComparator)

Specifies the ordering of the generated multimap's values for each key.

Since:

8.0

build

public ImmutableMultimap<K,V> build()

Returns a newly-created immutable multimap.