Package com.google.common.collect

Class ImmutableListMultimap.Builder<K,V>

java.lang.Object

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

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

Enclosing class:

ImmutableListMultimap<K,V>

public static final class ImmutableListMultimap.Builder<K,V>
extends ImmutableMultimap.Builder<K,V>

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

 static final Multimap<String, Integer> STRING_TO_INTEGER_MULTIMAP =
     new ImmutableListMultimap.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
ImmutableListMultimap<K,V>	build()	Returns a newly-created immutable list multimap.
ImmutableListMultimap.Builder<K,V>	expectedValuesPerKey(int expectedValuesPerKey)	Provides a hint for how many values will be associated with each key newly added to the builder after this call.
ImmutableListMultimap.Builder<K,V>	orderKeysBy(Comparator<? super K> keyComparator)	Specifies the ordering of the generated multimap's keys.
ImmutableListMultimap.Builder<K,V>	orderValuesBy(Comparator<? super V> valueComparator)	Specifies the ordering of the generated multimap's values for each key.
ImmutableListMultimap.Builder<K,V>	put(Map.Entry<? extends K,? extends V> entry)	Adds an entry to the built multimap.
ImmutableListMultimap.Builder<K,V>	put(K key, V value)	Adds a key-value mapping to the built multimap.
ImmutableListMultimap.Builder<K,V>	putAll(Multimap<? extends K,? extends V> multimap)	Stores another multimap's entries in the built multimap.
ImmutableListMultimap.Builder<K,V>	putAll(Iterable<? extends Map.Entry<? extends K,? extends V>> entries)	Adds entries to the built multimap.
ImmutableListMultimap.Builder<K,V>	putAll(K key, Iterable<? extends V> values)	Stores a collection of values with the same key in the built multimap.
ImmutableListMultimap.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 ImmutableListMultimap.builder().

Method Detail

expectedValuesPerKey

@CanIgnoreReturnValue
public ImmutableListMultimap.Builder<K,V> expectedValuesPerKey(int expectedValuesPerKey)

Provides a hint for how many values will be associated with each key newly added to the builder after this call. This does not change semantics, but may improve performance if expectedValuesPerKey is a good estimate.

This may be called more than once; each newly added key will use the most recent call to ImmutableMultimap.Builder.expectedValuesPerKey as its hint.

Overrides:

expectedValuesPerKey in class ImmutableMultimap.Builder<K,V>

Since:

33.3.0

put

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

Description copied from class: ImmutableMultimap.Builder

Adds a key-value mapping to the built multimap.

Overrides:

put in class ImmutableMultimap.Builder<K,V>

put

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

Adds an entry to the built multimap.

Overrides:

put in class ImmutableMultimap.Builder<K,V>

Since:

11.0

putAll

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

Adds entries to the built multimap.

Overrides:

putAll in class ImmutableMultimap.Builder<K,V>

Since:

19.0

putAll

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

Description copied from class: ImmutableMultimap.Builder

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

Overrides:

putAll in class ImmutableMultimap.Builder<K,V>

putAll

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

Description copied from class: ImmutableMultimap.Builder

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

Overrides:

putAll in class ImmutableMultimap.Builder<K,V>

putAll

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

Description copied from class: ImmutableMultimap.Builder

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.

Overrides:

putAll in class ImmutableMultimap.Builder<K,V>

orderKeysBy

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

Specifies the ordering of the generated multimap's keys.

Overrides:

orderKeysBy in class ImmutableMultimap.Builder<K,V>

Since:

8.0

orderValuesBy

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

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

Overrides:

orderValuesBy in class ImmutableMultimap.Builder<K,V>

Since:

8.0

build

public ImmutableListMultimap<K,V> build()

Returns a newly-created immutable list multimap.

Overrides:

build in class ImmutableMultimap.Builder<K,V>