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>

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();

Since:

2 (imported from Google Collections Library)

ImmutableMultimap.Builder

public ImmutableMultimap.Builder()

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

put

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

Adds a key-value mapping to the built multimap.

putAll

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

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

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

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

Specifies the ordering of the generated multimap's keys.

Since:

8

orderValuesBy

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

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

Since:

8

build

public ImmutableMultimap<K,V> build()

Returns a newly-created immutable multimap.