org.nustaq.kontraktor.reactivestreams

Interface KxPublisher<T>

All Superinterfaces:

org.reactivestreams.Publisher<T>

All Known Implementing Classes:

EventSink, KxPublisherActor, SyncProcessor

public interface KxPublisher<T>
extends org.reactivestreams.Publisher<T>

Created by ruedi on 30/06/15.

Method Summary

Modifier and Type	Method and Description
default org.nustaq.kontraktor.Actor	asActor()
default <OUT> KxPublisher<OUT>	async() insert an identity processor (with dedicated queue).
KxReactiveStreams	getKxStreamsInstance()
default void	iterator(Consumer<Iterator<T>> iteratingCode)
default void	iterator(int batchSize, Consumer<Iterator<T>> iteratingCode)
default <OUT> KxPublisher<OUT>	lossy()
default <OUT> KxPublisher<OUT>	lossyMap(Function<T,OUT> processor)
default <OUT> KxPublisher<OUT>	lossyMap(Function<T,OUT> processor, int batchSize)
default <OUT> KxPublisher<OUT>	map(Function<T,OUT> processor) insert an async processor (with dedicated queue, multiple subscribers)
default <OUT> KxPublisher<OUT>	map(Function<T,OUT> processor, int batchSize) insert an async processor (with dedicated queue, multiple subscribers)
default org.nustaq.kontraktor.remoting.base.ActorServer	serve(org.nustaq.kontraktor.remoting.base.ActorPublisher publisher) publish current stream onto a network connector Once the stream is complete or in error, the network connection will close.
default org.nustaq.kontraktor.remoting.base.ActorServer	serve(org.nustaq.kontraktor.remoting.base.ActorPublisher publisher, boolean closeOnDiscon, Consumer<org.nustaq.kontraktor.Actor> disconCallback)
default org.nustaq.kontraktor.remoting.base.ActorServer	serve(org.nustaq.kontraktor.remoting.base.ActorPublisher publisher, Consumer<org.nustaq.kontraktor.Actor> disconCallback) publish current stream onto a network connector, once the stream is complete or in error, the network connection will close.
default void	stream(Consumer<Stream<T>> streamingCode)
default void	stream(int batchSize, Consumer<Stream<T>> streamingCode)
default void	subscribe(org.nustaq.kontraktor.Callback<T> cb) consuming endpoint. requests data from publisher immediately after receiving onSubscribe callback.
default void	subscribe(int batchSize, org.nustaq.kontraktor.Callback<T> cb) consuming endpoint. requests data from publisher immediately after receiving onSubscribe callback.
default <OUT> KxPublisher<OUT>	syncMap(Function<T,OUT> processor) insert a synchronous processor (runs in provider thread).

Methods inherited from interface org.reactivestreams.Publisher

subscribe

Method Detail

subscribe

default void subscribe(org.nustaq.kontraktor.Callback<T> cb)

consuming endpoint. requests data from publisher immediately after receiving onSubscribe callback. Maps from reactive streams Subscriber to Kontraktor Callback. Call inherited subscribe(Publisher) to subscribe a 'standard' reactivestreams subscriber all events are routed to the callback e.g.

      subscriber( (event, err) -> {
     +          if (Actors.isComplete(err)) {
     +              System.out.println("complete");
     +          } else if (Actors.isError(err)) {
     +              System.out.println("ERROR");
     +          } else {
     +              // process event
     +          }
     +      }
 

Parameters:

-

getKxStreamsInstance

KxReactiveStreams getKxStreamsInstance()

subscribe

default void subscribe(int batchSize,
                       org.nustaq.kontraktor.Callback<T> cb)

consuming endpoint. requests data from publisher immediately after receiving onSubscribe callback. Maps from reactive streams Subscriber to Kontraktor Callback Call inherited subscribe(Publisher) to subscribe a 'standard' reactivestreams subscriber all events are routed to the callback e.g.

      subscriber( (event, err) -> {
     +          if (Actors.isComplete(err)) {
     +              System.out.println("complete");
     +          } else if (Actors.isError(err)) {
     +              System.out.println("ERROR");
     +          } else {
     +              // process event
     +          }
     +      }
 

stream

default void stream(Consumer<Stream<T>> streamingCode)

stream

default void stream(int batchSize,
                    Consumer<Stream<T>> streamingCode)

iterator

default void iterator(int batchSize,
                      Consumer<Iterator<T>> iteratingCode)

iterator

default void iterator(Consumer<Iterator<T>> iteratingCode)

map

default <OUT> KxPublisher<OUT> map(Function<T,OUT> processor)

insert an async processor (with dedicated queue, multiple subscribers)

Type Parameters:

OUT -

Parameters:

processor -

Returns:

async

default <OUT> KxPublisher<OUT> async()

insert an identity processor (with dedicated queue). Required e.g. if connecting streams/iterators to a synchronous publisher.

Type Parameters:

OUT -

Returns:

lossy

default <OUT> KxPublisher<OUT> lossy()

lossyMap

default <OUT> KxPublisher<OUT> lossyMap(Function<T,OUT> processor)

lossyMap

default <OUT> KxPublisher<OUT> lossyMap(Function<T,OUT> processor,
                                        int batchSize)

map

default <OUT> KxPublisher<OUT> map(Function<T,OUT> processor,
                                   int batchSize)

insert an async processor (with dedicated queue, multiple subscribers)

Type Parameters:

OUT -

Parameters:

processor -

batchSize -

Returns:

serve

default org.nustaq.kontraktor.remoting.base.ActorServer serve(org.nustaq.kontraktor.remoting.base.ActorPublisher publisher,
                                                              Consumer<org.nustaq.kontraktor.Actor> disconCallback)

publish current stream onto a network connector, once the stream is complete or in error, the network connection will close. Makes sense mostly for infinite streams (see RxStreamServer for a more sophisticated remoting example)

Parameters:

publisher -

disconCallback -

Returns:

serve

default org.nustaq.kontraktor.remoting.base.ActorServer serve(org.nustaq.kontraktor.remoting.base.ActorPublisher publisher,
                                                              boolean closeOnDiscon,
                                                              Consumer<org.nustaq.kontraktor.Actor> disconCallback)

serve

default org.nustaq.kontraktor.remoting.base.ActorServer serve(org.nustaq.kontraktor.remoting.base.ActorPublisher publisher)

publish current stream onto a network connector Once the stream is complete or in error, the network connection will close. (see RxStreamServer for a more sophisticated remoting example)

Parameters:

publisher -

Returns:

syncMap

default <OUT> KxPublisher<OUT> syncMap(Function<T,OUT> processor)

insert a synchronous processor (runs in provider thread). if 'this' is a remote reference to a remote stream, a queued async processor will be created (need queue + processing thread then)

Type Parameters:

OUT -

Parameters:

processor -

Returns:

asActor

default org.nustaq.kontraktor.Actor asActor()