reactor.io.net

Class ChannelStream<IN,OUT>

java.lang.Object

reactor.rx.Stream<IN>

reactor.io.net.ChannelStream<IN,OUT>

All Implemented Interfaces:

org.reactivestreams.Publisher<IN>, Channel<IN,OUT>, reactor.rx.action.support.NonBlocking

Direct Known Subclasses:

HttpChannel, NettyChannelStream, ZeroMQChannelStream

public abstract class ChannelStream<IN,OUT>
extends reactor.rx.Stream<IN>
implements Channel<IN,OUT>

An abstract Channel implementation that handles the basic interaction and behave as a Stream.

Nested Class Summary

Nested classes/interfaces inherited from interface reactor.io.net.Channel

Channel.ConsumerSpec

Field Summary

Fields

Modifier and Type	Field and Description
protected reactor.rx.broadcast.Broadcaster<IN>	contentStream
protected org.slf4j.Logger	log
protected PeerStream<IN,OUT,ChannelStream<IN,OUT>>	peer

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ChannelStream(reactor.Environment env, reactor.io.codec.Codec<reactor.io.buffer.Buffer,IN,OUT> codec, long prefetch, PeerStream<IN,OUT,ChannelStream<IN,OUT>> peer, reactor.core.Dispatcher ioDispatcher, reactor.core.Dispatcher eventsDispatcher)

Method Summary

Modifier and Type	Method and Description
protected void	cascadeErrorToPeer(java.lang.Throwable t)
<DECODED> reactor.rx.Stream<DECODED>	decode(reactor.io.codec.Codec<IN,DECODED,?> codec) Convert the current stream data into the decoded type produced by the passed codec
abstract java.lang.Object	delegate()
protected void	doDecoded(IN in)
protected abstract void	flush() Subclasses must implement this method to perform IO flushes.
long	getCapacity()
reactor.fn.Function<reactor.io.buffer.Buffer,IN>	getDecoder()
reactor.core.Dispatcher	getDispatcher()
reactor.fn.Function<OUT,reactor.io.buffer.Buffer>	getEncoder()
reactor.Environment	getEnvironment()
reactor.core.Dispatcher	getIODispatcher()
org.reactivestreams.Subscriber<IN>	in() Direct access to receiving side - should be used to forward incoming data manually or testing purpose
void	registerOnPeer() notify Peer subscribers the channel has been created and attach the Peer defined writer Publishers
void	sink(org.reactivestreams.Publisher<? extends OUT> source) Send data to the peer, listen for any error on write and close on terminal signal (complete|error).
void	sinkBuffers(org.reactivestreams.Publisher<? extends reactor.io.buffer.Buffer> source)
void	subscribe(org.reactivestreams.Subscriber<? super IN> s)
protected void	write(reactor.io.buffer.Buffer data, org.reactivestreams.Subscriber<?> onComplete, boolean flush) Subclasses must implement this method to perform the actual IO of writing data to the connection.
protected abstract void	write(java.nio.ByteBuffer data, org.reactivestreams.Subscriber<?> onComplete, boolean flush) Subclasses must implement this method to perform the actual IO of writing data to the connection.
protected abstract void	write(java.lang.Object data, org.reactivestreams.Subscriber<?> onComplete, boolean flush) Subclasses must implement this method to perform the actual IO of writing data to the connection.

Methods inherited from class reactor.rx.Stream

adaptiveConsume, adaptiveConsumeOn, batchConsume, batchConsumeOn, broadcast, broadcastOn, broadcastTo, buffer, buffer, buffer, buffer, buffer, buffer, buffer, buffer, buffer, buffer, buffer, cache, capacity, cast, cleanSubscriptionReference, combine, concatMap, concatWith, consume, consume, consume, consume, consume, consumeLater, consumeOn, consumeOn, consumeOn, count, count, defaultIfEmpty, dematerialize, dispatchOn, dispatchOn, dispatchOn, distinct, distinct, distinctUntilChanged, distinctUntilChanged, downstreamSubscription, elapsed, elementAt, elementAtOrDefault, env, exists, fanIn, filter, filter, finallyDo, flatMap, getTimer, groupBy, ignoreErrors, ignoreErrors, isReactivePull, join, joinWith, keepAlive, last, lift, log, log, map, materialize, merge, mergeWith, nest, next, notify, notify, observe, observeCancel, observeComplete, observeError, observeSubscribe, onErrorResumeNext, onErrorResumeNext, onErrorReturn, onErrorReturn, onOverflowBuffer, onOverflowBuffer, onOverflowDrop, partition, partition, recover, reduce, reduce, repeat, repeat, repeatWhen, requestWhen, retry, retry, retry, retry, retryWhen, sample, sample, sample, sample, sample, sample, sampleFirst, sampleFirst, sampleFirst, sampleFirst, sampleFirst, sampleFirst, scan, scan, skip, skip, skip, skipWhile, skipWhile, sort, sort, sort, sort, split, split, startWith, startWith, startWith, subscribe, subscribeOn, subscribeOn, subscribeOn, switchMap, take, take, take, takeWhile, takeWhile, tap, throttle, throttle, timeout, timeout, timeout, timeout, timestamp, toBlockingQueue, toBlockingQueue, toList, toList, toString, when, window, window, window, window, window, window, window, window, window, window, window, zip, zipWith, zipWith

Methods inherited from class java.lang.Object

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

Methods inherited from interface reactor.io.net.Channel

on, remoteAddress

Field Detail

log

protected final org.slf4j.Logger log

peer

protected final PeerStream<IN,OUT,ChannelStream<IN,OUT>> peer

contentStream

protected final reactor.rx.broadcast.Broadcaster<IN> contentStream

Constructor Detail

ChannelStream

protected ChannelStream(@Nonnull
                        reactor.Environment env,
                        @Nullable
                        reactor.io.codec.Codec<reactor.io.buffer.Buffer,IN,OUT> codec,
                        long prefetch,
                        @Nonnull
                        PeerStream<IN,OUT,ChannelStream<IN,OUT>> peer,
                        @Nonnull
                        reactor.core.Dispatcher ioDispatcher,
                        @Nonnull
                        reactor.core.Dispatcher eventsDispatcher)

Method Detail

subscribe

public void subscribe(org.reactivestreams.Subscriber<? super IN> s)

Specified by:

subscribe in interface org.reactivestreams.Publisher<IN>

sink

public final void sink(org.reactivestreams.Publisher<? extends OUT> source)

Description copied from interface: Channel

Send data to the peer, listen for any error on write and close on terminal signal (complete|error). If more than one publisher is attached (multiple calls to sink()) completion occurs after all publishers complete.

Specified by:

sink in interface Channel<IN,OUT>

Parameters:

source - the dataStream publishing OUT items to write on this channel

sinkBuffers

public final void sinkBuffers(org.reactivestreams.Publisher<? extends reactor.io.buffer.Buffer> source)

getEnvironment

public final reactor.Environment getEnvironment()

Overrides:

getEnvironment in class reactor.rx.Stream<IN>

getDispatcher

public final reactor.core.Dispatcher getDispatcher()

Overrides:

getDispatcher in class reactor.rx.Stream<IN>

getCapacity

public final long getCapacity()

Specified by:

getCapacity in interface reactor.rx.action.support.NonBlocking

Overrides:

getCapacity in class reactor.rx.Stream<IN>

getIODispatcher

public final reactor.core.Dispatcher getIODispatcher()

getDecoder

public final reactor.fn.Function<reactor.io.buffer.Buffer,IN> getDecoder()

getEncoder

public final reactor.fn.Function<OUT,reactor.io.buffer.Buffer> getEncoder()

in

public final org.reactivestreams.Subscriber<IN> in()

Direct access to receiving side - should be used to forward incoming data manually or testing purpose

Returns:

a writer for the current ChannelStream consumers

decode

public final <DECODED> reactor.rx.Stream<DECODED> decode(reactor.io.codec.Codec<IN,DECODED,?> codec)

Convert the current stream data into the decoded type produced by the passed codec

Returns:

the decoded stream

delegate

public abstract java.lang.Object delegate()

Returns:

the underlying native connection/channel in use

registerOnPeer

public void registerOnPeer()

notify Peer subscribers the channel has been created and attach the Peer defined writer Publishers

cascadeErrorToPeer

protected final void cascadeErrorToPeer(java.lang.Throwable t)

doDecoded

protected void doDecoded(IN in)

write

protected void write(reactor.io.buffer.Buffer data,
                     org.reactivestreams.Subscriber<?> onComplete,
                     boolean flush)

Subclasses must implement this method to perform the actual IO of writing data to the connection.

Parameters:

data - The data to write, as a Buffer.

onComplete - The callback to invoke when the write is complete.

write

protected abstract void write(java.nio.ByteBuffer data,
                              org.reactivestreams.Subscriber<?> onComplete,
                              boolean flush)

Subclasses must implement this method to perform the actual IO of writing data to the connection.

Parameters:

data - The data to write.

onComplete - The callback to invoke when the write is complete.

flush - whether to flush the underlying IO channel

write

protected abstract void write(java.lang.Object data,
                              org.reactivestreams.Subscriber<?> onComplete,
                              boolean flush)

Subclasses must implement this method to perform the actual IO of writing data to the connection.

Parameters:

data - The data to write.

onComplete - The callback to invoke when the write is complete.

flush - whether to flush the underlying IO channel

flush

protected abstract void flush()

Subclasses must implement this method to perform IO flushes.