Skip to main content

概览

什么是拦截器#

gRPC的拦截器（interceptor）类似 HTTP 应用的中间件（Middleware），请求中间件大家都知道是利用装饰器模式对最终处理请求的handler程序进行装饰，这样中间件就可以在处理请求前和完成处理后这两个时机上，拦截到发送给 handler 的请求以及 handler 返回给客户端的响应 。

中间件的最大的用处是可以把一些 handler 的前置和后置操作从 handler 程序中解耦出来，比如最常见的记录响应时长、记录请求和响应数据日志等操作往往是通过中间件程序实现的。

与 HTTP 应用的中间件同理，可以对gRPC的请求和响应进行拦截处理，而且既可以在 客户端进行拦截 ，也可以对服务器端进行拦截。利用拦截器，可以对gRPC进行很好的扩展，把一些业务逻辑外的冗余操作从 handler 中抽离，提升项目的开发效率和扩展性。

使用拦截器#

gRPC的服务器和客户端都是分别可以添加一个单向调用 (Unary) 的拦截器和流式调用 (Stream) 的拦截器。

这两种调用方式的区别可以理解为HTTP和WebSocket的区别

对于客户端的单向调用的拦截，只需定义一个 UnaryClientInterceptor 方法: 

type UnaryClientInterceptor func(ctx context.Context, method string, req, reply interface{}, cc *ClientConn, invoker UnaryInvoker, opts ...CallOption) error

而客户端流式调用的拦截，则需要定义一个 StreamClientInterceptor 方法:

type StreamClientInterceptor func(ctx context.Context, desc *StreamDesc, cc *ClientConn, method string, streamer Streamer, opts ...CallOption) (ClientStream, error)

同理，对于gRPC的服务端也有这两种调用的拦截器方法，分别是 UnaryServerInterceptor 和 StreamServerInterceptor：

type UnaryServerInterceptor func(ctx context.Context, req interface{}, info *UnaryServerInfo, handler UnaryHandler) (resp interface{}, err error)
type StreamServerInterceptor func(srv interface{}, ss ServerStream, info *StreamServerInfo, handler StreamHandler) error

链式拦截器#

与 HTTP 中间件不同的是，HTTP 中间件可以给每个 handler 程序应用多个中间件，gRPC官方也提供了链式操作，社区版也有提供.

eagle 里使用的是官方版本

官方版：新版本的 gRPC 已经提供了内置的链式 Interceptor 实现

// 客户端import "google.golang.org/grpc"
// dialoptions.goWithChainUnaryInterceptor(interceptors ...UnaryClientInterceptor) DialOptionWithStreamInterceptor(f StreamClientInterceptor) DialOption
// 服务端import "google.golang.org/grpc"
// server.goChainUnaryInterceptor(interceptors ...UnaryServerInterceptor) ServerOptionStreamInterceptor(i StreamServerInterceptor) ServerOption

社区版：由 grpc-ecosystem 提供的 链式功能

// 客户端import (  ...  "google.golang.org/grpc"  "github.com/grpc-ecosystem/go-grpc-middleware"  ...)
// chain.goChainUnaryClient(interceptors ...grpc.UnaryClientInterceptor) grpc.UnaryClientInterceptorChainStreamClient(interceptors ...grpc.StreamClientInterceptor) grpc.StreamClientInterceptor
// 服务端import (  "google.golang.org/grpc"  "github.com/grpc-ecosystem/go-grpc-middleware")
// chain.goChainUnaryServer(interceptors ...grpc.UnaryServerInterceptor) grpc.UnaryServerInterceptorChainStreamServer(interceptors ...grpc.StreamServerInterceptor) grpc.StreamServerInterceptor

社区拦截器插件#

利用拦截器，可以对gRPC进行扩展，利用社区的力量将gRPC发展壮大，也可以让开发者更灵活地处理gRPC流程中的业务逻辑。

下面列出了利用拦截器实现的一些功能框架：

Rererence#