io.grpc

Interface ClientInterceptor

All Known Implementing Classes:

ClientAuthInterceptor, HeaderClientInterceptor

@ThreadSafe
public interface ClientInterceptor

Interface for intercepting outgoing calls before they are dispatched by a Channel.

Implementers use this mechanism to add cross-cutting behavior to Channel and stub implementations. Common examples of such behavior include:

• Adding credentials to header metadata
• Logging and monitoring call behavior
• Request and response rewriting

Method Summary

Modifier and Type	Method and Description
<RequestT,ResponseT> Call<RequestT,ResponseT>	interceptCall(MethodDescriptor<RequestT,ResponseT> method, Channel next) Intercept Call creation by the next Channel.

Method Detail

interceptCall

<RequestT,ResponseT> Call<RequestT,ResponseT> interceptCall(MethodDescriptor<RequestT,ResponseT> method,
                                                            Channel next)

Intercept Call creation by the next Channel.

Many variations of interception are possible. Complex implementations may return a wrapper around the result of next.newCall(), whereas a simpler implementation may just modify the header metadata prior to returning the result of next.newCall().

Parameters:

method - the remote method to be called.

next - the channel which is being intercepted.

Returns:

the call object for the remote operation, never null.