Interface Stream.Builder<T>

Type Parameters:
T - the type of stream elements
All Superinterfaces:
Consumer<T>
Enclosing interface:
Stream<T>
public static interfaceStream.Builder<T>extendsConsumer<T>
A mutable builder for aStream. This allows the creation of aStream by generating elements individually and adding them to theBuilder (without the copying overhead that comes from using anArrayList as a temporary buffer.)

A stream builder has a lifecycle, which starts in a building phase, during which elements can be added, and then transitions to a built phase, after which elements may not be added. The built phase begins when thebuild() method is called, which creates an orderedStream whose elements are the elements that were added to the stream builder, in the order they were added.

Since:
1.8
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    accept(T t)
    Adds an element to the stream being built.
    add(T t)
    Adds an element to the stream being built.
    Builds the stream, transitioning this builder to the built state.

    Methods declared in interface java.util.function.Consumer

    andThen

  • Method Details

    • accept

      void accept(T t)
      Adds an element to the stream being built.
      Specified by:
      accept in interface Consumer<T>
      Parameters:
      t - the input argument
      Throws:
      IllegalStateException - if the builder has already transitioned to the built state

    • add

      default Stream.Builder<T> add(T t)
      Adds an element to the stream being built.
      Implementation Requirements:
      The default implementation behaves as if:
           accept(t)     return this;
      Parameters:
      t - the element to add
      Returns:
      this builder
      Throws:
      IllegalStateException - if the builder has already transitioned to the built state

    • build

      Stream<T> build()
      Builds the stream, transitioning this builder to the built state. AnIllegalStateException is thrown if there are further attempts to operate on the builder after it has entered the built state.
      Returns:
      the built stream
      Throws:
      IllegalStateException - if the builder has already transitioned to the built state