Spec-Zone .ru
спецификации, руководства, описания, API
|
T
- the type of stream elementspublic interface StreamBuilder<T> extends Consumer<T>
Stream
. This allows the creation of a
Stream
by generating elements individually and adding them to the
StreamBuilder
(without the copying overhead that comes from using
an ArrayList
as a temporary buffer.)
A StreamBuilder
has a lifecycle, where it 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 the build()
} method is called, which creates an ordered
Stream
whose elements are the elements that were added to the stream
builder, in the order they were added.
Primitive specializations of StreamBuilder
are provided
for int
, long
, and double
values.
Stream.builder()
Modifier and Type | Interface and Description |
---|---|
static interface |
StreamBuilder.OfDouble
A mutable builder for a
DoubleStream . |
static interface |
StreamBuilder.OfInt
A mutable builder for an
IntStream . |
static interface |
StreamBuilder.OfLong
A mutable builder for a
LongStream . |
Modifier and Type | Method and Description |
---|---|
void |
accept(T t)
Adds an element to the stream being built.
|
default StreamBuilder<T> |
add(T t)
Adds an element to the stream being built.
|
Stream<T> |
build()
Builds the stream, transitioning this builder to the built state.
|
void accept(T t)
accept
in interface Consumer<T>
t
- the input objectIllegalStateException
- if the builder has already transitioned to
the built statedefault StreamBuilder<T> add(T t)
accept(t)
return this;
t
- the element to addthis
builderIllegalStateException
- if the builder has already transitioned to
the built stateStream<T> build()
IllegalStateException
is thrown if there are further attempts
to operate on the builder after it has entered the built state.IllegalStateException
- if the builder has already transitioned to
the built state
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92