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>
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
-
Field Summary
FieldsFields inherited from class com.google.common.collect.ImmutableCollection.Builder
DEFAULT_INITIAL_CAPACITY -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAddselementto theImmutableList.Adds each element ofelementsto theImmutableList.private voidAdds each element ofelementsto theImmutableList.Adds each element ofelementsto theImmutableList.build()Returns a newly-createdImmutableListbased on the contents of theBuilder.(package private) ImmutableList<E> buildSorted(Comparator<? super E> comparator) Returns a newly-createdImmutableListbased on the contents of theBuilder, sorted according to the specified comparator.(package private) ImmutableList.Builder<E> combine(ImmutableList.Builder<E> builder) private voidensureRoomFor(int newElements) Methods inherited from class com.google.common.collect.ImmutableCollection.Builder
expandedCapacity
-
Field Details
-
contents
Object[] contents -
size
private int size -
copyOnWrite
private boolean copyOnWrite
-
-
Constructor Details
-
Builder
public Builder()Creates a new builder. The returned builder is equivalent to the builder generated byImmutableList.builder(). -
Builder
Builder(int capacity)
-
-
Method Details
-
ensureRoomFor
private void ensureRoomFor(int newElements) -
add
Addselementto theImmutableList.- Specified by:
addin classImmutableCollection.Builder<E>- Parameters:
element- the element to add- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementis null
-
add
Adds each element ofelementsto theImmutableList.- Overrides:
addin classImmutableCollection.Builder<E>- Parameters:
elements- theIterableto add to theImmutableList- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementsis null or contains a null element
-
add
-
addAll
Adds each element ofelementsto theImmutableList.- Overrides:
addAllin classImmutableCollection.Builder<E>- Parameters:
elements- theIterableto add to theImmutableList- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementsis null or contains a null element
-
addAll
Adds each element ofelementsto theImmutableList.- Overrides:
addAllin classImmutableCollection.Builder<E>- Parameters:
elements- theIteratorto add to theImmutableList- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementsis null or contains a null element
-
combine
-
build
Returns a newly-createdImmutableListbased on the contents of theBuilder.- Specified by:
buildin classImmutableCollection.Builder<E>
-
buildSorted
Returns a newly-createdImmutableListbased on the contents of theBuilder, sorted according to the specified comparator.
-