Class ImmutableList.Builder<E>

  • Enclosing class:
    ImmutableList<E>

    public static final class ImmutableList.Builder<E>
    extends ImmutableCollection.Builder<E>
    A builder for creating immutable list instances, especially public static final lists ("constant lists"). Example:

    Elements appear in the resulting list in the same order they were added to the builder.

    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
    • Constructor Summary

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

      • add

        @CanIgnoreReturnValue
        public ImmutableList.Builder<Eadd​(E element)
        Adds element to the ImmutableList.
        Specified by:
        add in class ImmutableCollection.Builder<E>
        Parameters:
        element - the element to add
        Returns:
        this Builder object
        Throws:
        java.lang.NullPointerException - if element is null
      • add

        @CanIgnoreReturnValue
        public ImmutableList.Builder<Eadd​(E... elements)
        Adds each element of elements to the ImmutableList.
        Overrides:
        add in class ImmutableCollection.Builder<E>
        Parameters:
        elements - the Iterable to add to the ImmutableList
        Returns:
        this Builder object
        Throws:
        java.lang.NullPointerException - if elements is null or contains a null element
      • addAll

        @CanIgnoreReturnValue
        public ImmutableList.Builder<EaddAll​(java.lang.Iterable<? extends E> elements)
        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:
        java.lang.NullPointerException - if elements is null or contains a null element
      • addAll

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