Source.lazyCompletionStageSource

Defers creation of a future source until there is demand.

Source operators

Description

Invokes the user supplied factory when the first downstream demand arrives. When the returned CompletionStage completes successfully the source switches over to the new source and emits downstream just like if it had been created up front. If the future or the factory fails the stream is failed.

Note that asynchronous boundaries (and other operators) in the stream may do pre-fetching which counter acts the laziness and will trigger the factory immediately.

See also lazySource.

Reactive Streams semantics

emits depends on the wrapped Source

completes depends on the wrapped Source

Found an error in this documentation? The source code for this page can be found here. Please feel free to edit and contribute a pull request.