Package com.google.common.collect

Class ImmutableList.Builder<E>

java.lang.Object
com.google.common.collect.ImmutableCollection.Builder<E>
com.google.common.collect.ImmutableList.Builder<E>
Enclosing class:
ImmutableList<E>
@Deprecated(since="2022-12-01") public static final class ImmutableList.Builder<E> extends ImmutableCollection.Builder<E>
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 list instances, especially public static final lists ("constant lists"). Example: 
   

    public static final ImmutableList<Color> GOOGLE_COLORS
        = new ImmutableList.Builder<Color>()
            .addAll(WEBSAFE_COLORS)
            .add(new Color(0, 191, 255))
            .build();

Builder instances can be reused; it is safe to call build() multiple times to build multiple lists in series. Each new list contains all the elements of the ones created before it.

Since:
2.0 (imported from Google Collections Library)

  • Constructor Details

    • Builder

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

  • Method Details

    • add

      public ImmutableList.Builder<E> add(E element)
      Deprecated.
      Adds element to the ImmutableList.
      Parameters:
      element - the element to add
      Returns:
      this Builder object
      Throws:
      NullPointerException - if element is null

    • addAll

      public ImmutableList.Builder<E> addAll(Iterable<? extends E> elements)
      Deprecated.
      Adds each element of elements to the ImmutableList.
      Parameters:
      elements - the Iterable to add to the ImmutableList
      Returns:
      this Builder object
      Throws:
      NullPointerException - if elements is null or contains a null element

    • add

      public ImmutableList.Builder<E> add(E... elements)
      Deprecated.
      Adds each element of elements to the ImmutableList.
      Parameters:
      elements - the Iterable to add to the ImmutableList
      Returns:
      this Builder object
      Throws:
      NullPointerException - if elements is null or contains a null element

    • addAll

      public ImmutableList.Builder<E> addAll(Iterator<? extends E> elements)
      Deprecated.
      Adds each element of elements to the ImmutableList.
      Overrides:
      addAll in class ImmutableCollection.Builder<E>
      Parameters:
      elements - the Iterable to add to the ImmutableList
      Returns:
      this Builder object
      Throws:
      NullPointerException - if elements is null or contains a null element

    • build

      public ImmutableList<E> build()
      Deprecated.
      Returns a newly-created ImmutableList based on the contents of the Builder.
      Specified by:
      build in class ImmutableCollection.Builder<E>