Package org.reactfx

Interface CompletionStageStream<T>

  • All Superinterfaces:
    EventStream<java.util.concurrent.CompletionStage<T>>, Observable<java.util.function.Consumer<? super java.util.concurrent.CompletionStage<T>>>
    All Known Implementing Classes:
    MappedToCompletionStageStream

    public interface CompletionStageStream<T>
    extends EventStream<java.util.concurrent.CompletionStage<T>>
    • Method Detail

      • await

        default AwaitingEventStream<Try<T>> await()
        Returns a new stream that emits the results of completions stages emitted from this stream when they become available.

        Note that results from the returned stream may arrive in different order than the completion stages emitted from this stream, due to asynchrony.

        If a completion stage emitted by this stream fails with exception e, Try.failure(e) is emitted from the returned stream.

      • await

        default AwaitingEventStream<Try<T>> await​(java.util.concurrent.Executor clientThreadExecutor)
        A variant of await() for streams that do not live on the JavaFX application thread.
        Parameters:
        clientThreadExecutor - single-thread executor that executes actions on the same thread on which this event stream lives.
        See Also:
        await()
      • awaitLatest

        default AwaitingEventStream<Try<T>> awaitLatest()
        Similar to await(), with one difference: for completion stages s1 and s2 emitted from this stream in this order, if s2 arrives before s1 is completed, then the result of s1 is discarded (i.e. not emitted from the returned stream).
        See Also:
        await()
      • awaitLatest

        default AwaitingEventStream<Try<T>> awaitLatest​(java.util.concurrent.Executor clientThreadExecutor)
        A variant of awaitLatest() for streams that do not live on the JavaFX application thread.
        Parameters:
        clientThreadExecutor - single-thread executor that executes actions on the same thread on which this event stream lives.
        See Also:
        awaitLatest()
      • awaitLatest

        default AwaitingEventStream<Try<T>> awaitLatest​(EventStream<?> canceller)
        Similar to awaitLatest(), with one addition: When an event is emitted from canceller, if the completion stage most recently emitted from this stream has not yet completed, its result is discarded (i.e. not emitted from the returned stream).
        Parameters:
        canceller - An event from this stream causes the currently expected result (if any) to be discarded. It can be used to signal that a new completion stage will arrive from this stream shortly, which makes the currently expected result outdated.
        See Also:
        awaitLatest()
      • awaitLatest

        default AwaitingEventStream<Try<T>> awaitLatest​(EventStream<?> canceller,
                                                        java.util.concurrent.Executor clientThreadExecutor)
        A variant of awaitLatest(EventStream) for streams that do not live on the JavaFX application thread.
        Parameters:
        clientThreadExecutor - single-thread executor that executes actions on the same thread on which this event stream lives.
        See Also:
        awaitLatest(EventStream)