com.google.common.collect

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();

    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 Detail

      • Builder

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

    • Method Detail

      • addAll

        public ImmutableList.Builder<E> addAll(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:
        NullPointerException - if elements is null or contains a null element

      • add

        public ImmutableList.Builder<E> add(E... elements)
        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

      • build

        public ImmutableList<E> build()
        Returns a newly-created ImmutableList based on the contents of the Builder.