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:
    
     public static final ImmutableList<Color> GOOGLE_COLORS
         = new ImmutableList.Builder<Color>()
             .addAll(WEBSAFE_COLORS)
             .add(new Color(0, 191, 255))
             .build();
     

    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.
        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.
        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.
        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