io.grpc.internal

Class AbstractServerStream

java.lang.Object

io.grpc.internal.AbstractStream

io.grpc.internal.AbstractServerStream

All Implemented Interfaces:

MessageFramer.Sink, ServerStream, Stream

public abstract class AbstractServerStream
extends AbstractStream
implements ServerStream, MessageFramer.Sink

Abstract base class for ServerStream implementations. Extending classes only need to implement transportState() and abstractServerStreamSink(). Must only be called from the sending application thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractServerStream.Sink A sink for outbound operations, separated from the stream simply to avoid name collisions/confusion.
protected static class	AbstractServerStream.TransportState This should only called from the transport thread (except for private interactions with AbstractServerStream).

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractServerStream(WritableBufferAllocator bufferAllocator, StatsTraceContext statsTraceCtx)

Method Summary

Modifier and Type	Method and Description
protected abstract AbstractServerStream.Sink	abstractServerStreamSink() Sink for transport to be called to perform outbound operations.
void	cancel(io.grpc.Status status) Tears down the stream, typically in the event of a timeout.
void	close(io.grpc.Status status, io.grpc.Metadata trailers) Closes the stream for both reading and writing.
void	deliverFrame(WritableBuffer frame, boolean endOfStream, boolean flush, int numMessages) Delivers a frame via the transport.
protected MessageFramer	framer() The framer to use for sending messages.
io.grpc.Attributes	getAttributes() Attributes describing stream.
String	getAuthority() Gets the authority this stream is addressed to.
boolean	isReady() If true, indicates that the transport is capable of sending additional messages without requiring excessive buffering internally.
void	request(int numMessages) Requests up to the given number of messages from the call to be delivered via StreamListener.messagesAvailable(StreamListener.MessageProducer).
void	setDecompressor(io.grpc.Decompressor decompressor) Sets the decompressor on the deframer.
void	setListener(ServerStreamListener serverStreamListener) Sets the server stream listener.
StatsTraceContext	statsTraceContext() The context for recording stats and traces for this stream.
protected abstract AbstractServerStream.TransportState	transportState() Obtain the transport state corresponding to this stream.
void	writeHeaders(io.grpc.Metadata headers) Writes custom metadata as headers on the response stream sent to the client.

Methods inherited from class io.grpc.internal.AbstractStream

endOfMessages, flush, onSendingBytes, setCompressor, setMessageCompression, writeMessage

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.Stream

flush, setCompressor, setMessageCompression, writeMessage

Constructor Detail

AbstractServerStream

protected AbstractServerStream(WritableBufferAllocator bufferAllocator,
                               StatsTraceContext statsTraceCtx)

Method Detail

transportState

protected abstract AbstractServerStream.TransportState transportState()

Description copied from class: AbstractStream

Obtain the transport state corresponding to this stream. Each stream must have its own unique transport state.

Specified by:

transportState in class AbstractStream

abstractServerStreamSink

protected abstract AbstractServerStream.Sink abstractServerStreamSink()

Sink for transport to be called to perform outbound operations. Each stream must have its own unique sink.

framer

protected final MessageFramer framer()

Description copied from class: AbstractStream

The framer to use for sending messages.

Specified by:

framer in class AbstractStream

request

public final void request(int numMessages)

Description copied from interface: Stream

Requests up to the given number of messages from the call to be delivered via StreamListener.messagesAvailable(StreamListener.MessageProducer). No additional messages will be delivered. If the stream has a start() method, it must be called before requesting messages.

Specified by:

request in interface Stream

Parameters:

numMessages - the requested number of messages to be delivered to the listener.

writeHeaders

public final void writeHeaders(io.grpc.Metadata headers)

Description copied from interface: ServerStream

Writes custom metadata as headers on the response stream sent to the client. This method may only be called once and cannot be called after calls to Stream.writeMessage(java.io.InputStream) or ServerStream.close(io.grpc.Status, io.grpc.Metadata).

Specified by:

writeHeaders in interface ServerStream

Parameters:

headers - to send to client.

deliverFrame

public final void deliverFrame(WritableBuffer frame,
                               boolean endOfStream,
                               boolean flush,
                               int numMessages)

Description copied from interface: MessageFramer.Sink

Delivers a frame via the transport.

Specified by:

deliverFrame in interface MessageFramer.Sink

Parameters:

frame - a non-empty buffer to deliver or null if the framer is being closed and there is no data to deliver.

endOfStream - whether the frame is the last one for the GRPC stream

flush - true if more data may not be arriving soon

numMessages - the number of messages that this series of frames represents

close

public final void close(io.grpc.Status status,
                        io.grpc.Metadata trailers)

Description copied from interface: ServerStream

Closes the stream for both reading and writing. A status code of Status.Code.OK implies normal termination of the stream. Any other value implies abnormal termination.

Attempts to read from or write to the stream after closing should be ignored by implementations, and should not throw exceptions.

Specified by:

close in interface ServerStream

Parameters:

status - details of the closure

trailers - an additional block of metadata to pass to the client on stream closure.

cancel

public final void cancel(io.grpc.Status status)

Description copied from interface: ServerStream

Tears down the stream, typically in the event of a timeout. This method may be called multiple times and from any thread.

Specified by:

cancel in interface ServerStream

isReady

public final boolean isReady()

Description copied from interface: Stream

If true, indicates that the transport is capable of sending additional messages without requiring excessive buffering internally. Otherwise, StreamListener.onReady() will be called when it turns true.

This is just a suggestion and the application is free to ignore it, however doing so may result in excessive buffering within the transport.

Specified by:

isReady in interface Stream

Overrides:

isReady in class AbstractStream

setDecompressor

public final void setDecompressor(io.grpc.Decompressor decompressor)

Description copied from interface: ServerStream

Sets the decompressor on the deframer. If the transport does not support compression, this may do nothing.

Specified by:

setDecompressor in interface ServerStream

Parameters:

decompressor - the decompressor to use.

getAttributes

public io.grpc.Attributes getAttributes()

Description copied from interface: ServerStream

Attributes describing stream. This is inherited from the transport attributes, and used as the basis of ServerCall.getAttributes().

Specified by:

getAttributes in interface ServerStream

Returns:

Attributes container

getAuthority

public String getAuthority()

Description copied from interface: ServerStream

Gets the authority this stream is addressed to.

Specified by:

getAuthority in interface ServerStream

Returns:

the authority string. null if not available.

setListener

public final void setListener(ServerStreamListener serverStreamListener)

Description copied from interface: ServerStream

Sets the server stream listener.

Specified by:

setListener in interface ServerStream

statsTraceContext

public StatsTraceContext statsTraceContext()

Description copied from interface: ServerStream

The context for recording stats and traces for this stream.

Specified by:

statsTraceContext in interface ServerStream