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) booleanprivate ImmutableSet.SetBuilderImpl<E>Fields inherited from class com.google.common.collect.ImmutableCollection.Builder
DEFAULT_INITIAL_CAPACITY -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAddselementto theImmutableCollectionbeing built.Adds each element ofelementsto theImmutableCollectionbeing built.Adds each element ofelementsto theImmutableSet, ignoring duplicate elements (only the first duplicate element is added).Adds each element ofelementsto theImmutableCollectionbeing built.build()Returns a newly-createdImmutableCollectionof the appropriate type, containing the elements provided to this builder.(package private) ImmutableSet.Builder<E>combine(ImmutableSet.Builder<E> other) (package private) voidcopy()(package private) final void(package private) voidforceJdk()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.BuilderAddselementto theImmutableCollectionbeing built.Note that each builder class covariantly returns its own type from this method.
- Specified by:
addin classImmutableCollection.Builder<E>- Parameters:
element- the element to add- Returns:
- this
Builderinstance
-
add
Description copied from class:ImmutableCollection.BuilderAdds each element ofelementsto theImmutableCollectionbeing built.Note that each builder class overrides this method in order to covariantly return its own type.
- Overrides:
addin classImmutableCollection.Builder<E>- Parameters:
elements- the elements to add- Returns:
- this
Builderinstance
-
addAll
Adds each element ofelementsto theImmutableSet, ignoring duplicate elements (only the first duplicate element is added).- Overrides:
addAllin classImmutableCollection.Builder<E>- Parameters:
elements- the elements to add- Returns:
- this
Builderobject - Throws:
NullPointerException- ifelementsis null or contains a null element
-
addAll
Description copied from class:ImmutableCollection.BuilderAdds each element ofelementsto theImmutableCollectionbeing built.Note that each builder class overrides this method in order to covariantly return its own type.
- Overrides:
addAllin classImmutableCollection.Builder<E>- Parameters:
elements- the elements to add- Returns:
- this
Builderinstance
-
combine
-
build
Description copied from class:ImmutableCollection.BuilderReturns a newly-createdImmutableCollectionof the appropriate type, containing the elements provided to this builder.Note that each builder class covariantly returns the appropriate type of
ImmutableCollectionfrom this method.- Specified by:
buildin classImmutableCollection.Builder<E>
-