com.aol.cyclops2.types.stream.reactive

Interface ReactiveStreamsTerminalOperations<T>

Type Parameters:

T - Element data in the Stream being processed.

All Known Subinterfaces:

AnyMSeq<W,T>, CollectionX<T>, CyclopsCollectable<T>, DequeX<T>, FluentCollectionX<T>, FluentSequenceX<T>, FoldableTraversable<T>, FutureStream<U>, LazyFluentCollectionX<T>, ListX<T>, MapX<K,V>, MutableCollectionX<T>, MutableSequenceX<T>, PBagX<T>, PersistentCollectionX<T>, PMapX<K,V>, POrderedSetX<T>, PQueueX<T>, PSetX<T>, PStackX<T>, PVectorX<T>, QueueX<T>, ReactiveSeq<T>, SetX<T>, SortedSetX<T>, Streamable<T>

All Known Implementing Classes:

AbstractLazyMutableCollection, AbstractLazyPersistentCollection, CollectionXImpl, LazyDequeX, LazyListX, LazyPBagX, LazyPOrderedSetX, LazyPQueueX, LazyPSetX, LazyPStackX, LazyPVectorX, LazyQueueX, LazySetX, LazySortedSetX, MapXImpl, PMapXImpl

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

Method Detail

forEach

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

forEach

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

forEach

<X extends java.lang.Throwable> org.reactivestreams.Subscription forEach(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)
          					    .forEach(2,System.out::println, e->e.printStackTrace(),()->System.out.println("the take!"));
          
     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 take!
 
 

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.

forEach

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

forEach

<X extends java.lang.Throwable> void forEach(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 take!"));
          
     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