io.grpc

Class ForwardingServerCall<RespT>

java.lang.Object

io.grpc.ServerCall<RespT>

io.grpc.ForwardingServerCall<RespT>

Direct Known Subclasses:

ForwardingServerCall.SimpleForwardingServerCall

public abstract class ForwardingServerCall<RespT>
extends ServerCall<RespT>

A ServerCall which forwards all of it's methods to another ServerCall.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ForwardingServerCall.SimpleForwardingServerCall<RespT> A simplified version of ForwardingServerCall where subclasses can pass in a ServerCall as the delegate.

Nested classes/interfaces inherited from class io.grpc.ServerCall

ServerCall.Listener<RequestT>

Constructor Summary

Constructors

Constructor and Description
ForwardingServerCall()

Method Summary

Modifier and Type	Method and Description
void	close(Status status, Metadata.Trailers trailers) Close the call with the provided status.
protected abstract ServerCall<RespT>	delegate() Returns the delegated ServerCall.
boolean	isCancelled() Returns true when the call is cancelled and the server is encouraged to abort processing to save resources, since the client will not be processing any further methods.
boolean	isReady() If true, indicates that the call 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 to ServerCall.Listener.onPayload(Object).
void	sendHeaders(Metadata.Headers headers) Send response header metadata prior to sending a response payload.
void	sendPayload(RespT payload) Send a response message.

Methods inherited from class java.lang.Object

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

Constructor Detail

ForwardingServerCall

public ForwardingServerCall()

Method Detail

delegate

protected abstract ServerCall<RespT> delegate()

Returns the delegated ServerCall.

request

public void request(int numMessages)

Description copied from class: ServerCall

Requests up to the given number of messages from the call to be delivered to ServerCall.Listener.onPayload(Object). Once numMessages have been delivered no further request messages will be delivered until more messages are requested by calling this method again.

Servers use this mechanism to provide back-pressure to the client for flow-control.

Specified by:

request in class ServerCall<RespT>

Parameters:

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

sendHeaders

public void sendHeaders(Metadata.Headers headers)

Description copied from class: ServerCall

Send response header metadata prior to sending a response payload. This method may only be called once and cannot be called after calls to Stream#sendPayload or #close.

Specified by:

sendHeaders in class ServerCall<RespT>

Parameters:

headers - metadata to send prior to any response body.

sendPayload

public void sendPayload(RespT payload)

Description copied from class: ServerCall

Send a response message. Payload messages are the primary form of communication associated with RPCs. Multiple response messages may exist for streaming calls.

Specified by:

sendPayload in class ServerCall<RespT>

Parameters:

payload - response message.

isReady

public boolean isReady()

Description copied from class: ServerCall

If true, indicates that the call is capable of sending additional messages without requiring excessive buffering internally. This event is just a suggestion and the application is free to ignore it, however doing so may result in excessive buffering within the call.

This implementation always returns true.

Overrides:

isReady in class ServerCall<RespT>

close

public void close(Status status,
                  Metadata.Trailers trailers)

Description copied from class: ServerCall

Close the call with the provided status. No further sending or receiving will occur. If status is not equal to Status.OK, then the call is said to have failed.

If status is not Status.CANCELLED and no errors or cancellations are known to have occured, then a ServerCall.Listener.onComplete() notification should be expected. Otherwise ServerCall.Listener.onCancel() has been or will be called.

Specified by:

close in class ServerCall<RespT>

isCancelled

public boolean isCancelled()

Description copied from class: ServerCall

Returns true when the call is cancelled and the server is encouraged to abort processing to save resources, since the client will not be processing any further methods. Cancellations can be caused by timeouts, explicit cancel by client, network errors, and similar.

This method may safely be called concurrently from multiple threads.

Specified by:

isCancelled in class ServerCall<RespT>