Package com.linecorp.armeria.common.grpc

Interface GoogleGrpcExceptionHandlerFunction

All Superinterfaces:

GrpcExceptionHandlerFunction

@UnstableApi
public interface GoogleGrpcExceptionHandlerFunction
extends GrpcExceptionHandlerFunction

A GoogleGrpcExceptionHandlerFunction that provides a way to include details of a status into a Metadata. You can implement a mapping function to convert Throwable into a Status which is stored in the `grpc-status-details-bin` key in the Metadata. If a given Throwable is an instance of either StatusRuntimeException or StatusException, the Status retrieved from the exception is returned with higher priority.

Method Summary

Modifier and Type	Method	Description
default @Nullable io.grpc.Status	apply(RequestContext ctx, Throwable throwable, io.grpc.Metadata metadata)	Maps the specified Throwable to a gRPC Status, and mutates the specified Metadata.
@Nullable com.google.rpc.Status	applyStatusProto(RequestContext ctx, Throwable throwable, io.grpc.Metadata metadata)	Maps the specified Throwable to a Status, and mutates the specified Metadata.

Methods inherited from interface com.linecorp.armeria.common.grpc.GrpcExceptionHandlerFunction

orElse

Method Details

apply

@Nullable
default @Nullable io.grpc.Status apply(RequestContext ctx,
 Throwable throwable,
 io.grpc.Metadata metadata)

Description copied from interface: GrpcExceptionHandlerFunction

Maps the specified Throwable to a gRPC Status, and mutates the specified Metadata. If null is returned, the built-in mapping rule is used by default.

Specified by:

apply in interface GrpcExceptionHandlerFunction

applyStatusProto

@Nullable com.google.rpc.Status applyStatusProto(RequestContext ctx,
 Throwable throwable,
 io.grpc.Metadata metadata)

Maps the specified Throwable to a Status, and mutates the specified Metadata. The `grpc-status-details-bin` key is ignored since it will be overwritten by apply(RequestContext, Throwable, Metadata). If null is returned, the built-in mapping rule is used by default.