io.grpc

Class ClientInterceptors.CheckedForwardingCall<ReqT,RespT>

java.lang.Object

io.grpc.Call<ReqT,RespT>

io.grpc.ForwardingCall<ReqT,RespT>

io.grpc.ClientInterceptors.CheckedForwardingCall<ReqT,RespT>

Enclosing class:

ClientInterceptors

public abstract static class ClientInterceptors.CheckedForwardingCall<ReqT,RespT>
extends ForwardingCall<ReqT,RespT>

A ForwardingCall that delivers exceptions from its start logic to the call listener.

Call.start(Call.Listener, Metadata.Headers) should not throw any exception other than those caused by misuse, e.g., IllegalStateException. CheckedForwardingCall provides checkedStart() in which throwing exceptions is allowed.

Nested Class Summary

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

ForwardingCall.SimpleForwardingCall<ReqT,RespT>

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

Call.Listener<T>

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CheckedForwardingCall(Call<ReqT,RespT> delegate)

Method Summary

Modifier and Type	Method and Description
protected abstract void	checkedStart(Call.Listener<RespT> responseListener, Metadata.Headers headers) Subclasses implement the start logic here that would normally belong to start().
protected Call<ReqT,RespT>	delegate() Returns the delegated Call.
void	start(Call.Listener<RespT> responseListener, Metadata.Headers headers) Start a call, using responseListener for processing response messages.

Methods inherited from class io.grpc.ForwardingCall

cancel, halfClose, isReady, request, sendPayload

Methods inherited from class java.lang.Object

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

Constructor Detail

CheckedForwardingCall

protected CheckedForwardingCall(Call<ReqT,RespT> delegate)

Method Detail

checkedStart

protected abstract void checkedStart(Call.Listener<RespT> responseListener,
                                     Metadata.Headers headers)
                              throws Exception

Subclasses implement the start logic here that would normally belong to start().

Implementation should call this.delegate().start() in the normal path. Exceptions may safely be thrown prior to calling this.delegate().start(). Such exceptions will be handled by CheckedForwardingCall and be delivered to responseListener. Exceptions must not be thrown after calling this.delegate().start(), as this can result in Call.Listener.onClose(io.grpc.Status, io.grpc.Metadata.Trailers) being called multiple times.

Throws:

Exception

delegate

protected final Call<ReqT,RespT> delegate()

Description copied from class: ForwardingCall

Returns the delegated Call.

Specified by:

delegate in class ForwardingCall<ReqT,RespT>

start

public final void start(Call.Listener<RespT> responseListener,
                        Metadata.Headers headers)

Description copied from class: Call

Start a call, using responseListener for processing response messages.

Overrides:

start in class ForwardingCall<ReqT,RespT>

Parameters:

responseListener - receives response messages

headers - which can contain extra call metadata, e.g. authentication credentials.