raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 11

Add Source.fromJavaStream as convenient method alias (#28881)

Browse source
This commit is contained in:
kerr 2020-04-28 17:15:11 +08:00 • committed by GitHub
parent 404d45ea82
commit 6b5d544deb
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
6 changed files with 87 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

39
akka-docs/src/main/paradox/stream/operators/Source/fromJavaStream.md Normal file
View file

@ -0,0 +1,39 @@
# fromJavaStream
Stream the values from a Java 8 `Stream`, requesting the next value when there is demand.
@ref[Source operators](../index.md#source-operators)
@@@div { .group-scala }
## Signature
@@signature [Source.scala](/akka-stream/src/main/scala/akka/stream/scaladsl/Source.scala) { #fromJavaStream }
@@@
## Description
Stream the values from a Java 8 `Stream`, requesting the next value when there is demand. The iterator will be created anew
for each materialization, which is the reason the @scala[`method`] @java[`factory`] takes a @scala[`function`] @java[`Creator`] rather than an `Stream` directly.
You can use [[Source.async]] to create asynchronous boundaries between synchronous java stream and the rest of flow.
## Example
Scala
: @@snip [From.scala](/akka-docs/src/test/scala/docs/stream/operators/source/From.scala) { #from-javaStream }
Java
: @@snip [From.java](/akka-docs/src/test/java/jdocs/stream/operators/source/From.java) { #from-javaStream }
## Reactive Streams semantics
@@@div { .callout }
**emits** the next value returned from the iterator
**completes** when the iterator reaches its end
@@@