io.grpc.stub

Class Calls

java.lang.Object

io.grpc.stub.Calls

public class Calls
extends Object

Utility functions for processing different call idioms. We have one-to-one correspondence between utilities in this class and the potential signatures in a generated stub class so that the runtime can vary behavior without requiring regeneration of the stub.

Constructor Summary

Constructors

Constructor and Description
Calls()

Method Summary

Modifier and Type	Method and Description
static <ReqT,RespT> StreamObserver<ReqT>	asyncClientStreamingCall(Call<ReqT,RespT> call, StreamObserver<RespT> responseObserver) Executes a client-streaming call returning a StreamObserver for the request messages.
static <ReqT,RespT> void	asyncServerStreamingCall(Call<ReqT,RespT> call, ReqT param, StreamObserver<RespT> responseObserver) Executes a server-streaming call with a response StreamObserver.
static <ReqT,RespT> void	asyncUnaryCall(Call<ReqT,RespT> call, ReqT param, StreamObserver<RespT> observer) Executes a unary call with a response StreamObserver.
static <ReqT,RespT> RespT	blockingClientStreamingCall(Call<ReqT,RespT> call, Iterator<ReqT> clientStream) Executes a client-streaming call with a blocking Iterator of request messages.
static <ReqT,RespT> Iterator<RespT>	blockingServerStreamingCall(Call<ReqT,RespT> call, ReqT param) Executes a server-streaming call returning a blocking Iterator over the response stream.
static <ReqT,RespT> RespT	blockingUnaryCall(Call<ReqT,RespT> call, ReqT param) Executes a unary call and blocks on the response.
static <RequestT,ResponseT> MethodDescriptor<RequestT,ResponseT>	createMethodDescriptor(String fullServiceName, Method<RequestT,ResponseT> method) Creates a MethodDescriptor for a given method.
static <ReqT,RespT> StreamObserver<ReqT>	duplexStreamingCall(Call<ReqT,RespT> call, StreamObserver<RespT> responseObserver) Executes a duplex-streaming call.
static <ReqT,RespT> ListenableFuture<RespT>	unaryFutureCall(Call<ReqT,RespT> call, ReqT param) Executes a unary call and returns a ListenableFuture to the response.

Methods inherited from class java.lang.Object

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

Constructor Detail

Calls

public Calls()

Method Detail

createMethodDescriptor

public static <RequestT,ResponseT> MethodDescriptor<RequestT,ResponseT> createMethodDescriptor(String fullServiceName,
                                                                                               Method<RequestT,ResponseT> method)

Creates a MethodDescriptor for a given method.

Parameters:

fullServiceName - fully qualified service name

method - carries all invariants of the method

unaryFutureCall

public static <ReqT,RespT> ListenableFuture<RespT> unaryFutureCall(Call<ReqT,RespT> call,
                                                                   ReqT param)

Executes a unary call and returns a ListenableFuture to the response.

Returns:

a future for the single response message.

blockingUnaryCall

public static <ReqT,RespT> RespT blockingUnaryCall(Call<ReqT,RespT> call,
                                                   ReqT param)

Executes a unary call and blocks on the response.

Returns:

the single response message.

asyncUnaryCall

public static <ReqT,RespT> void asyncUnaryCall(Call<ReqT,RespT> call,
                                               ReqT param,
                                               StreamObserver<RespT> observer)

Executes a unary call with a response StreamObserver.

blockingServerStreamingCall

public static <ReqT,RespT> Iterator<RespT> blockingServerStreamingCall(Call<ReqT,RespT> call,
                                                                       ReqT param)

Executes a server-streaming call returning a blocking Iterator over the response stream.

Returns:

an iterator over the response stream.

asyncServerStreamingCall

public static <ReqT,RespT> void asyncServerStreamingCall(Call<ReqT,RespT> call,
                                                         ReqT param,
                                                         StreamObserver<RespT> responseObserver)

Executes a server-streaming call with a response StreamObserver.

blockingClientStreamingCall

public static <ReqT,RespT> RespT blockingClientStreamingCall(Call<ReqT,RespT> call,
                                                             Iterator<ReqT> clientStream)

Executes a client-streaming call with a blocking Iterator of request messages.

Returns:

the single response value.

asyncClientStreamingCall

public static <ReqT,RespT> StreamObserver<ReqT> asyncClientStreamingCall(Call<ReqT,RespT> call,
                                                                         StreamObserver<RespT> responseObserver)

Executes a client-streaming call returning a StreamObserver for the request messages.

Returns:

request stream observer.

duplexStreamingCall

public static <ReqT,RespT> StreamObserver<ReqT> duplexStreamingCall(Call<ReqT,RespT> call,
                                                                    StreamObserver<RespT> responseObserver)

Executes a duplex-streaming call.

Returns:

request stream observer.