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

java.lang.Object
  com.google.common.collect.ImmutableMap.Builder<K,V>
      com.google.common.collect.ImmutableSortedMap.Builder<K,V>

Enclosing class:

ImmutableSortedMap<K,V>

public static class ImmutableSortedMap.Builder<K,V>
extends ImmutableMap.Builder<K,V>

A builder for creating immutable sorted map instances, especially public static final maps ("constant maps"). Example:

   static final ImmutableSortedMap<Integer, String> INT_TO_WORD =
       new ImmutableSortedMap.Builder<Integer, String>(Ordering.natural())
           .put(1, "one")
           .put(2, "two")
           .put(3, "three")
           .build();

Builder instances can be reused - it is safe to call build() multiple times to build multiple maps in series. Each map is a superset of the maps created before it.

Since:

2 (imported from Google Collections Library)

ImmutableSortedMap.Builder

public ImmutableSortedMap.Builder(Comparator<? super K> comparator)

Creates a new builder. The returned builder is equivalent to the builder generated by ImmutableSortedMap.orderedBy(java.util.Comparator).

put

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

Associates key with value in the built map. Duplicate keys, according to the comparator (which might be the keys' natural order), are not allowed, and will cause build() to fail.

Overrides:

put in class ImmutableMap.Builder<K,V>

putAll

public ImmutableSortedMap.Builder<K,V> putAll(Map<? extends K,? extends V> map)

Associates all of the given map's keys and values in the built map. Duplicate keys, according to the comparator (which might be the keys' natural order), are not allowed, and will cause build() to fail.

Overrides:

putAll in class ImmutableMap.Builder<K,V>

Throws:

NullPointerException - if any key or value in map is null

build

public ImmutableSortedMap<K,V> build()

Returns a newly-created immutable sorted map.

Overrides:

build in class ImmutableMap.Builder<K,V>

Throws:

IllegalArgumentException - if any two keys are equal according to the comparator (which might be the keys' natural order)