io.grpc.stub

Class ServerCallStreamObserver<V>

java.lang.Object

io.grpc.stub.CallStreamObserver<V>

io.grpc.stub.ServerCallStreamObserver<V>

All Implemented Interfaces:

StreamObserver<V>

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1788")
 @DoNotMock
public abstract class ServerCallStreamObserver<V>
extends CallStreamObserver<V>

A refinement of CallStreamObserver to allows for interaction with call cancellation events on the server side.

Like StreamObserver, implementations are not required to be thread-safe; if multiple threads will be writing to an instance concurrently, the application must synchronize its calls.

Constructor Summary

Constructors

Constructor and Description
ServerCallStreamObserver()

Method Summary

Modifier and Type	Method and Description
abstract boolean	isCancelled() If true indicates that the call has been cancelled by the remote peer.
abstract void	setCompression(String compression) Sets the compression algorithm to use for the call.
abstract void	setOnCancelHandler(Runnable onCancelHandler) Set a Runnable that will be called if the calls isCancelled() state changes from false to true.

Methods inherited from class io.grpc.stub.CallStreamObserver

disableAutoInboundFlowControl, isReady, request, setMessageCompression, setOnReadyHandler

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.grpc.stub.StreamObserver

onCompleted, onError, onNext

Constructor Detail

ServerCallStreamObserver

public ServerCallStreamObserver()

Method Detail

isCancelled

public abstract boolean isCancelled()

If true indicates that the call has been cancelled by the remote peer.

This method may safely be called concurrently from multiple threads.

setOnCancelHandler

public abstract void setOnCancelHandler(Runnable onCancelHandler)

Set a Runnable that will be called if the calls isCancelled() state changes from false to true. It is guaranteed that execution of the Runnable are serialized with calls to the 'inbound' StreamObserver.

Note that the handler may be called some time after isCancelled() has transitioned to true as other callbacks may still be executing in the 'inbound' observer.

Parameters:

onCancelHandler - to call when client has cancelled the call.

setCompression

public abstract void setCompression(String compression)

Sets the compression algorithm to use for the call. May only be called before sending any messages.

Parameters:

compression - the compression algorithm to use.