io.grpc.util

Class TransmitStatusRuntimeExceptionInterceptor

java.lang.Object

io.grpc.util.TransmitStatusRuntimeExceptionInterceptor

All Implemented Interfaces:

io.grpc.ServerInterceptor

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/2189")
public final class TransmitStatusRuntimeExceptionInterceptor
extends Object
implements io.grpc.ServerInterceptor

A class that intercepts uncaught exceptions of type StatusRuntimeException and handles them by closing the ServerCall, and transmitting the exception's status and metadata to the client.

Without this interceptor, gRPC will strip all details and close the ServerCall with a generic Status.UNKNOWN code.

Security warning: the Status and Metadata may contain sensitive server-side state information, and generally should not be sent to clients. Only install this interceptor if all clients are trusted.

Method Summary

Modifier and Type	Method and Description
static io.grpc.ServerInterceptor	instance()
<ReqT,RespT> io.grpc.ServerCall.Listener<ReqT>	interceptCall(io.grpc.ServerCall<ReqT,RespT> call, io.grpc.Metadata headers, io.grpc.ServerCallHandler<ReqT,RespT> next)

Methods inherited from class java.lang.Object

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

Method Detail

instance

public static io.grpc.ServerInterceptor instance()

interceptCall

public <ReqT,RespT> io.grpc.ServerCall.Listener<ReqT> interceptCall(io.grpc.ServerCall<ReqT,RespT> call,
                                                                    io.grpc.Metadata headers,
                                                                    io.grpc.ServerCallHandler<ReqT,RespT> next)

Specified by:

interceptCall in interface io.grpc.ServerInterceptor