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

java.lang.Object
  extended by com.google.common.collect.ImmutableMultimap.Builder<K,V>
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();

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.


Constructor Summary
ImmutableMultimap.Builder()
          Creates a new builder.
 
Method Summary
 ImmutableMultimap<K,V> build()
           
 ImmutableMultimap.Builder<K,V> put(K key, V value)
          Adds a key-value mapping 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

ImmutableMultimap.Builder

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

Method Detail

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. If a later value is null, earlier values may be added to the builder.

build

public ImmutableMultimap<K,V> build()