com.aol.cyclops.types.stream.reactive

Interface ReactiveStreamsTerminalFutureOperations<T>

Type Parameters:

T - Element data in the Stream being processed.

All Known Subinterfaces:

FutureOperations<T>

All Known Implementing Classes:

BaseFutureOperationsImpl, LazyFutureStreamFutureOpterationsImpl, ReactiveSeqFutureOpterationsImpl

public interface ReactiveStreamsTerminalFutureOperations<T>

Interface for reactive-streams based terminal operations, requires simple-react to be on the classpath.

Method Summary

Modifier and Type	Method and Description
<X extends java.lang.Throwable> ReactiveTask	forEachEvent(java.util.function.Consumer<? super T> consumerElement, java.util.function.Consumer<? super java.lang.Throwable> consumerError, java.lang.Runnable onComplete) Perform a forEach operation over the Stream capturing any elements and errors in the supplied consumers when the entire Stream has been processed an onComplete event will be recieved.
<X extends java.lang.Throwable> ReactiveTask	forEachWithError(java.util.function.Consumer<? super T> consumerElement, java.util.function.Consumer<? super java.lang.Throwable> consumerError) Perform a forEach operation over the Stream capturing any elements and errors in the supplied consumers,
<X extends java.lang.Throwable> ReactiveTask	forEachX(long numberOfElements, java.util.function.Consumer<? super T> consumer) Perform a forEach operation over the Stream, without closing it, consuming only the specified number of elements from the Stream, at this time.
<X extends java.lang.Throwable> ReactiveTask	forEachXEvents(long numberOfElements, java.util.function.Consumer<? super T> consumer, java.util.function.Consumer<? super java.lang.Throwable> consumerError, java.lang.Runnable onComplete) Perform a forEach operation over the Stream without closing it, capturing any elements and errors in the supplied consumers, but only consuming the specified number of elements from the Stream, at this time.
<X extends java.lang.Throwable> ReactiveTask	forEachXWithError(long numberOfElements, java.util.function.Consumer<? super T> consumer, java.util.function.Consumer<? super java.lang.Throwable> consumerError) Perform a forEach operation over the Stream without closing it, capturing any elements and errors in the supplied consumers, but only consuming the specified number of elements from the Stream, at this time.

Method Detail

forEachX

<X extends java.lang.Throwable> ReactiveTask forEachX(long numberOfElements,
                                                      java.util.function.Consumer<? super T> consumer)

Perform a forEach operation over the Stream, without closing it, consuming only the specified number of elements from the Stream, at this time. More elements can be consumed later, by called request on the returned Subscription

 
     ReactiveTask next = ReactiveSeq.of(1,2,3,4)
                                  .futureOperations(exec)
          					    .forEachX(2,System.out::println)
          						.join();
          
     System.out.println("First batch processed!");
     
     next.request(2);
     
      System.out.println("Second batch processed!");
      
     //prints
     1
     2
     First batch processed!
     3
     4 
     Second batch processed!
 
 

Parameters:

numberOfElements - To consume from the Stream at this time

consumer - To accept incoming events from the Stream

Returns:

ReactiveTask so that further processing can be continued or cancelled.

forEachXWithError

<X extends java.lang.Throwable> ReactiveTask forEachXWithError(long numberOfElements,
                                                               java.util.function.Consumer<? super T> consumer,
                                                               java.util.function.Consumer<? super java.lang.Throwable> consumerError)

Perform a forEach operation over the Stream without closing it, capturing any elements and errors in the supplied consumers, but only consuming the specified number of elements from the Stream, at this time. More elements can be consumed later, by called request on the returned Subscription

 
     ReactiveTask next = ReactiveSeq.of(()->1,()->2,()->{throw new RuntimeException()},()->4)
                                  .futureOperations(exec)
                                  .map(Supplier::get)
          					    .forEachXWithError(2,System.out::println, e->e.printStackTrace());
          
     System.out.println("First batch processed!");
     
     next.request(2);
     
      System.out.println("Second batch processed!");
      
     //prints
     1
     2
     First batch processed!
     
     RuntimeException Stack Trace on System.err
     
     4 
     Second batch processed!
 
 

Parameters:

numberOfElements - To consume from the Stream at this time

consumer - To accept incoming elements from the Stream

consumerError - To accept incoming processing errors from the Stream

Returns:

ReactiveTask so that further processing can be continued or cancelled.

forEachXEvents

<X extends java.lang.Throwable> ReactiveTask forEachXEvents(long numberOfElements,
                                                            java.util.function.Consumer<? super T> consumer,
                                                            java.util.function.Consumer<? super java.lang.Throwable> consumerError,
                                                            java.lang.Runnable onComplete)

Perform a forEach operation over the Stream without closing it, capturing any elements and errors in the supplied consumers, but only consuming the specified number of elements from the Stream, at this time. More elements can be consumed later, by called request on the returned Subscription, when the entire Stream has been processed an onComplete event will be recieved.

 
     ReactiveTask next = ReactiveSeq.of(()->1,()->2,()->{throw new RuntimeException()},()->4)
                                  .futureOperations(exec)
                                  .map(Supplier::get)
          					    .forEachXEvents(2,System.out::println, e->e.printStackTrace(),()->System.out.println("the end!"));
          
     System.out.println("First batch processed!");
     
     next.request(2);
     
      System.out.println("Second batch processed!");
      
     //prints
     1
     2
     First batch processed!
     
     RuntimeException Stack Trace on System.err
     
     4 
     Second batch processed!
     The end!
 
 

Parameters:

numberOfElements - To consume from the Stream at this time

consumer - To accept incoming elements from the Stream

consumerError - To accept incoming processing errors from the Stream

onComplete - To run after an onComplete event

Returns:

ReactiveTask so that further processing can be continued or cancelled.

forEachWithError

<X extends java.lang.Throwable> ReactiveTask forEachWithError(java.util.function.Consumer<? super T> consumerElement,
                                                              java.util.function.Consumer<? super java.lang.Throwable> consumerError)

Perform a forEach operation over the Stream capturing any elements and errors in the supplied consumers,

 
     ReactiveTask next = ReactiveSeq.of(()->1,()->2,()->{throw new RuntimeException()},()->4)
                                  .futureOperations(exec)
                                  .map(Supplier::get)
          					    .forEachWithError(System.out::println, e->e.printStackTrace());
          
     System.out.println("processed!");
     
    
      
     //prints
     1
     2
     RuntimeException Stack Trace on System.err
     4
     processed!
     
 
 

Parameters:

consumerElement - To accept incoming elements from the Stream

consumerError - To accept incoming processing errors from the Stream

Returns:

ReactiveTask so that further processing can be continued or cancelled.

forEachEvent

<X extends java.lang.Throwable> ReactiveTask forEachEvent(java.util.function.Consumer<? super T> consumerElement,
                                                          java.util.function.Consumer<? super java.lang.Throwable> consumerError,
                                                          java.lang.Runnable onComplete)

Perform a forEach operation over the Stream capturing any elements and errors in the supplied consumers when the entire Stream has been processed an onComplete event will be recieved.

 
     ReactiveTask next = ReactiveSeq.of(()->1,()->2,()->{throw new RuntimeException()},()->4)
                                  .futureOperations(exec)
                                  .map(Supplier::get)
          					    .forEachEvents(System.out::println, e->e.printStackTrace(),()->System.out.println("the end!"));
          
     System.out.println("processed!");
     
      
     //prints
     1
     2
     RuntimeException Stack Trace on System.err
      4 
     processed!
     
     
 
 

Parameters:

consumerElement - To accept incoming elements from the Stream

consumerError - To accept incoming processing errors from the Stream

onComplete - To run after an onComplete event

Returns:

ReactiveTask so that further processing can be continued or cancelled.