Skip to content

Latest commit

 

History

History

recovery

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

grpc_recovery

import "github.com/grpc-ecosystem/go-grpc-middleware/recovery"

grpc_recovery are intereceptors that recover from gRPC handler panics.

Server Side Recovery Middleware

By default a panic will be converted into a gRPC error with code.Internal.

Handling can be customised by providing an alternate recovery function.

Please see examples for simple examples of use.

Example:

Click to expand code.
// Shared options for the logger, with a custom gRPC code to log level function.
	opts := []grpc_recovery.Option{
	    grpc_recovery.WithRecoveryHandler(customFunc),
	}
	// Create a server. Recovery handlers should typically be last in the chain so that other middleware
	// (e.g. logging) can operate on the recovered state instead of being directly affected by any panic
	server := grpc.NewServer(
	    grpc_middleware.WithUnaryServerChain(
	        grpc_recovery.UnaryServerInterceptor(opts...),
	    ),
	    grpc_middleware.WithStreamServerChain(
	        grpc_recovery.StreamServerInterceptor(opts...),
	    ),
	)
	return server

doc.go interceptors.go options.go

func StreamServerInterceptor(opts ...Option) grpc.StreamServerInterceptor

StreamServerInterceptor returns a new streaming server interceptor for panic recovery.

func UnaryServerInterceptor(opts ...Option) grpc.UnaryServerInterceptor

UnaryServerInterceptor returns a new unary server interceptor for panic recovery.

type Option func(*options)
func WithRecoveryHandler(f RecoveryHandlerFunc) Option

WithRecoveryHandler customizes the function for recovering from a panic.

type RecoveryHandlerFunc func(p interface{}) (err error)

RecoveryHandlerFunc is a function that recovers from the panic p by returning an error.


Generated by godoc2ghmd