Class ImmutableMap.Builder<K,​V>

  • Direct Known Subclasses:
    ImmutableBiMap.Builder, ImmutableSortedMap.Builder
    Enclosing class:
    ImmutableMap<K,​V>

    @Deprecated(since="2022-12-01")
    public static class ImmutableMap.Builder<K,​V>
    extends java.lang.Object
    Deprecated.
    The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023
    A builder for creating immutable map instances, especially public static final maps ("constant maps"). Example:
       
    
        static final ImmutableMap<String, Integer> WORD_TO_INT =
            new ImmutableMap.Builder<String, Integer>()
                .put("one", 1)
                .put("two", 2)
                .put("three", 3)
                .build();

    For small immutable maps, the ImmutableMap.of() methods are even more convenient.

    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.0 (imported from Google Collections Library)
    • Constructor Summary

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

      • Builder

        public Builder()
        Deprecated.
        Creates a new builder. The returned builder is equivalent to the builder generated by ImmutableMap.builder().
    • Method Detail

      • put

        public ImmutableMap.Builder<K,​V> put​(K key,
                                                   V value)
        Deprecated.
        Associates key with value in the built map. Duplicate keys are not allowed, and will cause build() to fail.
      • put

        public ImmutableMap.Builder<K,​V> put​(java.util.Map.Entry<? extends K,​? extends V> entry)
        Deprecated.
        Adds the given entry to the map, making it immutable if necessary. Duplicate keys are not allowed, and will cause build() to fail.
        Since:
        11.0
      • putAll

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

        public ImmutableMap<K,​V> build()
        Deprecated.
        Returns a newly-created immutable map.
        Throws:
        java.lang.IllegalArgumentException - if duplicate keys were added