com.aol.simple.react.collectors

Class ReactCollector<U>

java.lang.Object

com.aol.simple.react.collectors.ReactCollector<U>

public class ReactCollector<U>
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
ReactCollector()

Method Summary

Modifier and Type	Method and Description
StageWithResults<java.util.List<U>,U>	block() React and block List<String> strings = 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.
<X> StageWithResults<X,U>	block(java.util.stream.Collector collector)
<X> StageWithResults<X,U>	block(java.util.stream.Collector collector, java.util.function.Predicate<Status> breakout)
StageWithResults<java.util.List<U>,U>	block(java.util.function.Predicate<Status> breakout) React and block with breakout Sometimes you may not need to block until all the work is complete, one result or a subset may be enough.
<X> StageWithResults<X,U>	blockAndExtract(Extractor extractor) Block until tasks complete and return a value determined by the extractor supplied.
<X> StageWithResults<X,U>	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.
StageWithResults<U,U>	first() Block until first result recieved
StageWithResults<U,U>	last() Block until all results recieved.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ReactCollector

public ReactCollector()

Method Detail

block

public StageWithResults<java.util.List<U>,U> block()

React and block List<String> strings = 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

block

public <X> StageWithResults<X,U> block(java.util.stream.Collector 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

public StageWithResults<U,U> first()

Block until first result recieved

Returns:

first result. throws InterruptedException,ExecutionException

last

public StageWithResults<U,U> last()

Block until all results recieved.

Returns:

last result throws InterruptedException,ExecutionException

blockAndExtract

public <X> StageWithResults<X,U> 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

public <X> StageWithResults<X,U> 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

block

public StageWithResults<java.util.List<U>,U> block(java.util.function.Predicate<Status> breakout)

React and block with breakout Sometimes you may not need to block until all the work is complete, one result or a subset may be enough. To faciliate this, block can accept a Predicate functional interface that will allow SimpleReact to stop blocking the current thread when the Predicate has been fulfilled. E.g. List<String> strings = SimpleReact.<Integer, Integer> react(() -> 1, () -> 2, () -> 3) .then(it -> it * 100) .then(it -> "*" + it) .block(status -> status.getCompleted()>1); In this example the current thread will unblock once more than one result has been returned.

Parameters:

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

Returns:

List of Completed results of currently active stage at full completion point or when breakout triggered (which ever comes first). throws InterruptedException,ExecutionException

block

public <X> StageWithResults<X,U> block(java.util.stream.Collector collector,
                                       java.util.function.Predicate<Status> breakout)

Parameters:

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

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

Returns:

Completed results of currently active stage at full completion point or when breakout triggered (which ever comes first), in aggregated in form determined by collector throws InterruptedException,ExecutionException