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.