io.grpc.internal

Class AbstractStream.TransportState

java.lang.Object

io.grpc.internal.AbstractStream.TransportState

All Implemented Interfaces:

MessageDeframer.Listener

Direct Known Subclasses:

AbstractClientStream.TransportState, AbstractServerStream.TransportState

Enclosing class:

AbstractStream

public abstract static class AbstractStream.TransportState
extends Object
implements MessageDeframer.Listener

Stream state as used by the transport. This should only called from the transport thread (except for private interactions with AbstractStream).

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_ONREADY_THRESHOLD The default number of queued bytes for a given stream, below which StreamListener.onReady() will be called.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TransportState(int maxMessageSize, StatsTraceContext statsTraceCtx, TransportTracer transportTracer)

Method Summary

Modifier and Type	Method and Description
protected void	closeDeframer(boolean stopDelivery) Closes the deframer and frees any resources.
protected void	deframe(ReadableBuffer frame) Called to parse a received frame and attempt delivery of any completed messages.
StatsTraceContext	getStatsTraceContext()
protected TransportTracer	getTransportTracer()
protected abstract StreamListener	listener() Override this method to provide a stream listener.
void	messagesAvailable(StreamListener.MessageProducer producer) Called to deliver the next complete message.
void	onSentBytes(int numBytes) Event handler to be called by the subclass when a number of bytes has been sent to the remote endpoint.
protected void	onStreamAllocated() Event handler to be called by the subclass when the stream's headers have passed any connection flow control (i.e., MAX_CONCURRENT_STREAMS).
protected void	onStreamDeallocated() Notify that the stream does not exist in a usable state any longer.
void	requestMessagesFromDeframer(int numMessages) Called to request the given number of messages from the deframer.
void	runOnTransportThread(Runnable r)
protected void	setDecompressor(Decompressor decompressor)
protected void	setFullStreamDecompressor(io.grpc.internal.GzipInflatingBuffer fullStreamDecompressor)

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.grpc.internal.MessageDeframer.Listener

bytesRead, deframeFailed, deframerClosed

Field Detail

DEFAULT_ONREADY_THRESHOLD

public static final int DEFAULT_ONREADY_THRESHOLD

The default number of queued bytes for a given stream, below which StreamListener.onReady() will be called.

See Also:

Constant Field Values

Constructor Detail

TransportState

protected TransportState(int maxMessageSize,
                         StatsTraceContext statsTraceCtx,
                         TransportTracer transportTracer)

Method Detail

setFullStreamDecompressor

protected void setFullStreamDecompressor(io.grpc.internal.GzipInflatingBuffer fullStreamDecompressor)

listener

protected abstract StreamListener listener()

Override this method to provide a stream listener.

messagesAvailable

public void messagesAvailable(StreamListener.MessageProducer producer)

Description copied from interface: MessageDeframer.Listener

Called to deliver the next complete message.

Specified by:

messagesAvailable in interface MessageDeframer.Listener

Parameters:

producer - single message producer wrapping the message.

closeDeframer

protected final void closeDeframer(boolean stopDelivery)

Closes the deframer and frees any resources. After this method is called, additional calls will have no effect.

When stopDelivery is false, the deframer will wait to close until any already queued messages have been delivered.

The deframer will invoke ApplicationThreadDeframer.deframerClosed(boolean) upon closing.

Parameters:

stopDelivery - interrupt pending deliveries and close immediately

deframe

protected final void deframe(ReadableBuffer frame)

Called to parse a received frame and attempt delivery of any completed messages. Must be called from the transport thread.

requestMessagesFromDeframer

public final void requestMessagesFromDeframer(int numMessages)

Called to request the given number of messages from the deframer. Must be called from the transport thread.

getStatsTraceContext

public final StatsTraceContext getStatsTraceContext()

setDecompressor

protected final void setDecompressor(Decompressor decompressor)

onStreamAllocated

protected void onStreamAllocated()

Event handler to be called by the subclass when the stream's headers have passed any connection flow control (i.e., MAX_CONCURRENT_STREAMS). It may call the listener's StreamListener.onReady() handler if appropriate. This must be called from the transport thread, since the listener may be called back directly.

onStreamDeallocated

protected final void onStreamDeallocated()

Notify that the stream does not exist in a usable state any longer. This causes AbstractStream.isReady() to return false from this point forward.

This does not generally need to be called explicitly by the transport, as it is handled implicitly by AbstractClientStream and AbstractServerStream.

onSentBytes

public final void onSentBytes(int numBytes)

Event handler to be called by the subclass when a number of bytes has been sent to the remote endpoint. May call back the listener's StreamListener.onReady() handler if appropriate. This must be called from the transport thread, since the listener may be called back directly.

Parameters:

numBytes - the number of bytes that were sent.

getTransportTracer

protected TransportTracer getTransportTracer()

runOnTransportThread

public void runOnTransportThread(Runnable r)