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