io.grpc

Interface ServerInterceptor

All Known Implementing Classes:

HeaderServerInterceptor

@ThreadSafe
public interface ServerInterceptor

Interface for intercepting incoming calls before that are dispatched by ServerCallHandler.

Implementers use this mechanism to add cross-cutting behavior to server-side calls. Common example of such behavior include:

• Enforcing valid authentication credentials
• Logging and monitoring call behavior
• Delegating calls to other servers

Method Summary

Modifier and Type	Method and Description
<RequestT,ResponseT> ServerCall.Listener<RequestT>	interceptCall(String method, ServerCall<ResponseT> call, Metadata.Headers headers, ServerCallHandler<RequestT,ResponseT> next) Intercept ServerCall dispatch by the next ServerCallHandler.

Method Detail

interceptCall

<RequestT,ResponseT> ServerCall.Listener<RequestT> interceptCall(String method,
                                                                 ServerCall<ResponseT> call,
                                                                 Metadata.Headers headers,
                                                                 ServerCallHandler<RequestT,ResponseT> next)

Intercept ServerCall dispatch by the next ServerCallHandler. General semantics of ServerCallHandler.startCall(java.lang.String, io.grpc.ServerCall<ResponseT>, io.grpc.Metadata.Headers) apply and the returned ServerCall.Listener must not be null.

If the implementation throws an exception, call will be closed with an error. Implementations must not throw an exception if they started processing that may use call on another thread.

Parameters:

method - fully qualified method name of the call

call - object to receive response messages

next - next processor in the interceptor chain

Returns:

listener for processing incoming messages for call, never null.