com.aol.cyclops.types.stream.reactive

Interface ReactiveStreamsTerminalOperations<T>

Type Parameters:

T - Element data in the Stream being processed.

All Known Subinterfaces:

AnyMSeq<T>, LazyFutureStream<U>, ReactiveSeq<T>

public interface ReactiveStreamsTerminalOperations<T>

Interface for reactive-streams based terminal operations, requires simple-react to be on the classpath. Used by SequenceM & javaslang ReactiveStream

Method Summary

Modifier and Type	Method and Description
<X extends java.lang.Throwable> void	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> void	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> org.reactivestreams.Subscription	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> org.reactivestreams.Subscription	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> org.reactivestreams.Subscription	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> org.reactivestreams.Subscription 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 e.g.

 
     Subscription next = ReactiveSeq.of(1,2,3,4)
          					    .forEachX(2,System.out::println);
          
     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:

Subscription so that further processing can be continued or cancelled.

forEachXWithError

<X extends java.lang.Throwable> org.reactivestreams.Subscription 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

 
     Subscription next = ReactiveSeq.of(()->1,()->2,()->throw new RuntimeException(),()->4)
                                  .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:

Subscription so that further processing can be continued or cancelled.

forEachXEvents

<X extends java.lang.Throwable> org.reactivestreams.Subscription 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.

 
     Subscription next = ReactiveSeq.of(()->1,()->2,()->throw new RuntimeException(),()->4)
                                  .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:

Subscription so that further processing can be continued or cancelled.

forEachWithError

<X extends java.lang.Throwable> void 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,

 
     Subscription next = ReactiveSeq.of(()->1,()->2,()->throw new RuntimeException(),()->4)
                                  .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

forEachEvent

<X extends java.lang.Throwable> void 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.

 
     Subscription next = ReactiveSeq.of(()->1,()->2,()->throw new RuntimeException(),()->4)
                                  .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