com.google.common.collect
Class ImmutableCollection.Builder<E>

java.lang.Object
  extended by com.google.common.collect.ImmutableCollection.Builder<E>
Direct Known Subclasses:
ImmutableList.Builder, ImmutableMultiset.Builder, ImmutableSet.Builder
Enclosing class:
ImmutableCollection<E>

public abstract static class ImmutableCollection.Builder<E>
extends Object

Abstract base class for builders of ImmutableCollection types.

Since:
10.0

Method Summary
 ImmutableCollection.Builder<E> add(E... elements)
          Adds each element of elements to the ImmutableCollection being built.
abstract  ImmutableCollection.Builder<E> add(E element)
          Adds element to the ImmutableCollection being built.
 ImmutableCollection.Builder<E> addAll(Iterable<? extends E> elements)
          Adds each element of elements to the ImmutableCollection being built.
 ImmutableCollection.Builder<E> addAll(Iterator<? extends E> elements)
          Adds each element of elements to the ImmutableCollection being built.
abstract  ImmutableCollection<E> build()
          Returns a newly-created ImmutableCollection of the appropriate type, containing the elements provided to this builder.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

add

public abstract ImmutableCollection.Builder<E> add(E element)
Adds element to the ImmutableCollection being built.

Note that each builder class covariantly returns its own type from this method.

Parameters:
element - the element to add
Returns:
this Builder instance
Throws:
NullPointerException - if element is null

add

public ImmutableCollection.Builder<E> add(E... elements)
Adds each element of elements to the ImmutableCollection being built.

Note that each builder class overrides this method in order to covariantly return its own type.

Parameters:
elements - the elements to add
Returns:
this Builder instance
Throws:
NullPointerException - if elements is null or contains a null element

addAll

public ImmutableCollection.Builder<E> addAll(Iterable<? extends E> elements)
Adds each element of elements to the ImmutableCollection being built.

Note that each builder class overrides this method in order to covariantly return its own type.

Parameters:
elements - the elements to add
Returns:
this Builder instance
Throws:
NullPointerException - if elements is null or contains a null element

addAll

public ImmutableCollection.Builder<E> addAll(Iterator<? extends E> elements)
Adds each element of elements to the ImmutableCollection being built.

Note that each builder class overrides this method in order to covariantly return its own type.

Parameters:
elements - the elements to add
Returns:
this Builder instance
Throws:
NullPointerException - if elements is null or contains a null element

build

public abstract ImmutableCollection<E> build()
Returns a newly-created ImmutableCollection 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.



Copyright © 2010-2012. All Rights Reserved.