io.grpc

Class Channel

java.lang.Object

io.grpc.Channel

Direct Known Subclasses:

ChannelImpl

@ThreadSafe
public abstract class Channel
extends Object

A Channel provides an abstraction over the transport layer that is designed to be consumed by stub implementations. Channel and its associated types Call and Call.Listener exchange parsed request and response objects whereas the transport layer only works with serialized data.

Applications can add common cross-cutting behaviors to stubs by decorating Channel implementations using ClientInterceptor. It is expected that most application code will not use this class directly but rather work with stubs that have been bound to a Channel that was decorated during application initialization,

Constructor Summary

Constructors

Constructor and Description
Channel()

Method Summary

Modifier and Type	Method and Description
abstract <RequestT,ResponseT> Call<RequestT,ResponseT>	newCall(MethodDescriptor<RequestT,ResponseT> methodDescriptor) Create a Call to the remote operation specified by the given MethodDescriptor.

Methods inherited from class java.lang.Object

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

Constructor Detail

Channel

public Channel()

Method Detail

newCall

public abstract <RequestT,ResponseT> Call<RequestT,ResponseT> newCall(MethodDescriptor<RequestT,ResponseT> methodDescriptor)

Create a Call to the remote operation specified by the given MethodDescriptor. The returned Call does not trigger any remote behavior until Call.start(Call.Listener, Metadata.Headers) is invoked.

Parameters:

methodDescriptor - describes the name and parameter types of the operation to call.

Returns:

a Call bound to the specified method.