public static final class ImmutableList.Builder<E> extends ImmutableCollection.Builder<E>
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.
Constructor and Description |
---|
Builder()
Creates a new builder.
|
Modifier and Type | Method and Description |
---|---|
ImmutableList.Builder<E> |
add(E... elements)
Adds each element of
elements to the ImmutableList . |
ImmutableList.Builder<E> |
add(E element)
Adds
element to the ImmutableList . |
ImmutableList.Builder<E> |
addAll(Iterable<? extends E> elements)
Adds each element of
elements to the ImmutableList . |
ImmutableList.Builder<E> |
addAll(Iterator<? extends E> elements)
Adds each element of
elements to the ImmutableList . |
ImmutableList<E> |
build()
Returns a newly-created
ImmutableList based on the contents of the Builder . |
public Builder()
ImmutableList.builder()
.@CanIgnoreReturnValue public ImmutableList.Builder<E> add(E element)
element
to the ImmutableList
.add
in class ImmutableCollection.Builder<E>
element
- the element to addBuilder
objectNullPointerException
- if element
is null@CanIgnoreReturnValue public ImmutableList.Builder<E> add(E... elements)
elements
to the ImmutableList
.add
in class ImmutableCollection.Builder<E>
elements
- the Iterable
to add to the ImmutableList
Builder
objectNullPointerException
- if elements
is null or contains a null element@CanIgnoreReturnValue public ImmutableList.Builder<E> addAll(Iterable<? extends E> elements)
elements
to the ImmutableList
.addAll
in class ImmutableCollection.Builder<E>
elements
- the Iterable
to add to the ImmutableList
Builder
objectNullPointerException
- if elements
is null or contains a null element@CanIgnoreReturnValue public ImmutableList.Builder<E> addAll(Iterator<? extends E> elements)
elements
to the ImmutableList
.addAll
in class ImmutableCollection.Builder<E>
elements
- the Iterator
to add to the ImmutableList
Builder
objectNullPointerException
- if elements
is null or contains a null elementpublic ImmutableList<E> build()
ImmutableList
based on the contents of the Builder
.build
in class ImmutableCollection.Builder<E>
Copyright © 2010–2019. All rights reserved.