Class ImmutableBiMap.Builder<K,​V>

  • Enclosing class:
    ImmutableBiMap<K,​V>

    public static final class ImmutableBiMap.Builder<K,​V>
    extends ImmutableMap.Builder<K,​V>
    A builder for creating immutable bimap instances, especially public static final bimaps ("constant bimaps"). Example:
    
     static final ImmutableBiMap<String, Integer> WORD_TO_INT =
         new ImmutableBiMap.Builder<String, Integer>()
             .put("one", 1)
             .put("two", 2)
             .put("three", 3)
             .build();
     

    For small immutable bimaps, the ImmutableBiMap.of() methods are even more convenient.

    By default, a Builder will generate bimaps that iterate over entries in the order they were inserted into the builder. For example, in the above example, WORD_TO_INT.entrySet() is guaranteed to iterate over the entries in the order "one"=1, "two"=2, "three"=3, and keySet() and values() respect the same order. If you want a different order, consider using orderEntriesByValue(Comparator), which changes this builder to sort entries by value.

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

    Since:
    2.0
    • Constructor Summary

      Constructors 
      Constructor Description
      Builder()
      Creates a new builder.
    • Method Detail

      • putAll

        public ImmutableBiMap.Builder<K,​VputAll​(java.util.Map<? extends K,​? extends V> map)
        Associates all of the given map's keys and values in the built bimap. Duplicate keys or values are not allowed, and will cause build() to fail.
        Overrides:
        putAll in class ImmutableMap.Builder<K,​V>
        Throws:
        java.lang.NullPointerException - if any key or value in map is null
      • putAll

        @Beta
        public ImmutableBiMap.Builder<K,​VputAll​(java.lang.Iterable<? extends java.util.Map.Entry<? extends K,​? extends V>> entries)
        Adds all of the given entries to the built bimap. Duplicate keys or values are not allowed, and will cause build() to fail.
        Overrides:
        putAll in class ImmutableMap.Builder<K,​V>
        Throws:
        java.lang.NullPointerException - if any key, value, or entry is null
        Since:
        19.0
      • orderEntriesByValue

        @Beta
        public ImmutableBiMap.Builder<K,​VorderEntriesByValue​(java.util.Comparator<? super V> valueComparator)
        Configures this Builder to order entries by value according to the specified comparator.

        The sort order is stable, that is, if two entries have values that compare as equivalent, the entry that was inserted first will be first in the built map's iteration order.

        Overrides:
        orderEntriesByValue in class ImmutableMap.Builder<K,​V>
        Throws:
        java.lang.IllegalStateException - if this method was already called
        Since:
        19.0