Package com.google.common.collect
Class ImmutableSet.Builder<E>
java.lang.Object
com.google.common.collect.ImmutableCollection.Builder<E>
com.google.common.collect.ImmutableSet.Builder<E>
- Direct Known Subclasses:
ImmutableSortedSet.Builder
- Enclosing class:
ImmutableSet<E>
A builder for creating
ImmutableSet
instances. Example:
static final ImmutableSet<Color> GOOGLE_COLORS =
ImmutableSet.<Color>builder()
.addAll(WEBSAFE_COLORS)
.add(new Color(0, 191, 255))
.build();
Elements appear in the resulting set in the same order they were first added to the builder.
Building does not change the state of the builder, so it is still possible to add more elements and to build again.
- Since:
- 2.0
-
Field Summary
FieldsModifier and TypeFieldDescription(package private) boolean
private ImmutableSet.SetBuilderImpl
<E> Fields inherited from class com.google.common.collect.ImmutableCollection.Builder
DEFAULT_INITIAL_CAPACITY
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAddselement
to theImmutableCollection
being built.Adds each element ofelements
to theImmutableCollection
being built.Adds each element ofelements
to theImmutableSet
, ignoring duplicate elements (only the first duplicate element is added).Adds each element ofelements
to theImmutableCollection
being built.build()
Returns a newly-createdImmutableCollection
of the appropriate type, containing the elements provided to this builder.(package private) ImmutableSet.Builder
<E> combine
(ImmutableSet.Builder<E> other) (package private) void
copy()
(package private) final void
(package private) void
forceJdk()
Methods inherited from class com.google.common.collect.ImmutableCollection.Builder
expandedCapacity
-
Field Details
-
impl
-
forceCopy
boolean forceCopy
-
-
Constructor Details
-
Builder
public Builder() -
Builder
Builder(int capacity) -
Builder
Builder(boolean subclass)
-
-
Method Details
-
forceJdk
void forceJdk() -
copyIfNecessary
final void copyIfNecessary() -
copy
void copy() -
add
Description copied from class:ImmutableCollection.Builder
Addselement
to theImmutableCollection
being built.Note that each builder class covariantly returns its own type from this method.
- Specified by:
add
in classImmutableCollection.Builder<E>
- Parameters:
element
- the element to add- Returns:
- this
Builder
instance
-
add
Description copied from class:ImmutableCollection.Builder
Adds each element ofelements
to theImmutableCollection
being built.Note that each builder class overrides this method in order to covariantly return its own type.
- Overrides:
add
in classImmutableCollection.Builder<E>
- Parameters:
elements
- the elements to add- Returns:
- this
Builder
instance
-
addAll
Adds each element ofelements
to theImmutableSet
, ignoring duplicate elements (only the first duplicate element is added).- Overrides:
addAll
in classImmutableCollection.Builder<E>
- Parameters:
elements
- the elements to add- Returns:
- this
Builder
object - Throws:
NullPointerException
- ifelements
is null or contains a null element
-
addAll
Description copied from class:ImmutableCollection.Builder
Adds each element ofelements
to theImmutableCollection
being built.Note that each builder class overrides this method in order to covariantly return its own type.
- Overrides:
addAll
in classImmutableCollection.Builder<E>
- Parameters:
elements
- the elements to add- Returns:
- this
Builder
instance
-
combine
-
build
Description copied from class:ImmutableCollection.Builder
Returns a newly-createdImmutableCollection
of the appropriate type, containing the elements provided to this builder.Note that each builder class covariantly returns the appropriate type of
ImmutableCollection
from this method.- Specified by:
build
in classImmutableCollection.Builder<E>
-