com.aol.simple.react.stream.traits

Interface BlockingStream<U>

All Known Subinterfaces:

EagerFutureStream<U>, EagerSimpleReactStream<U>, FutureStream<U>, LazyFutureStream<U>, LazySimpleReactStream<U>, LazyStream<U>, SimpleReactStream<U>

All Known Implementing Classes:

EagerFutureStreamImpl, LazyFutureStreamImpl, SimpleReactStreamImpl

public interface BlockingStream<U>

Method Summary

Modifier and Type	Method and Description
default java.util.List<U>	block() React and block
default <R,A> R	block(java.util.stream.Collector<? super U,A,R> collector)
default <R> R	blockAndExtract(Extractor extractor) Block until tasks complete and return a value determined by the extractor supplied.
default <R> R	blockAndExtract(Extractor extractor, java.util.function.Predicate<Status> breakout) Block until tasks complete, or breakout conditions met and return a value determined by the extractor supplied.
default U	first() Block until first result received
java.util.Optional<java.util.function.Consumer<java.lang.Throwable>>	getErrorHandler()
java.lang.Object	getLastActive()
default U	last() Block until all results received.

Method Detail

getErrorHandler

java.util.Optional<java.util.function.Consumer<java.lang.Throwable>> getErrorHandler()

block

default java.util.List<U> block()

React and block

  
		List<String> strings = new SimpleReact().<Integer, Integer> react(() -> 1, () -> 2, () -> 3)
				.then((it) -> it * 100)
				.then((it) -> "*" + it)
				.block();
		
                                
          

In this example, once the current thread of execution meets the React block method, it will block until all tasks have been completed. The result will be returned as a List. The Reactive tasks triggered by the Suppliers are non-blocking, and are not impacted by the block method until they are complete. Block, only blocks the current thread.

Returns:

Results of currently active stage aggregated in a List throws InterruptedException,ExecutionException

getLastActive

java.lang.Object getLastActive()

block

default <R,A> R block(java.util.stream.Collector<? super U,A,R> collector)

Parameters:

collector - to perform aggregation / reduction operation on the results (e.g. to Collect into a List or String)

Returns:

Results of currently active stage in aggregated in form determined by collector throws InterruptedException,ExecutionException

first

default U first()

Block until first result received

Returns:

first result. throws InterruptedException,ExecutionException

last

default U last()

Block until all results received.

Returns:

last result throws InterruptedException,ExecutionException

blockAndExtract

default <R> R blockAndExtract(Extractor extractor)

Block until tasks complete and return a value determined by the extractor supplied.

Parameters:

extractor - used to determine which value should be returned, recieves current collected input and extracts a return value

Returns:

Value determined by the supplied extractor throws InterruptedException,ExecutionException

blockAndExtract

default <R> R blockAndExtract(Extractor extractor,
                              java.util.function.Predicate<Status> breakout)

Block until tasks complete, or breakout conditions met and return a value determined by the extractor supplied.

Parameters:

extractor - used to determine which value should be returned, recieves current collected input and extracts a return value

breakout - Predicate that determines whether the block should be continued or removed

Returns:

Value determined by the supplied extractor throws InterruptedException,ExecutionException