GRPC支持拦截器特性,提高了GRPC的灵活性和扩展性。

拦截器使用

服务端

使用grpcx.Server.ChainUnary增加额外的服务端拦截器:

  1. c := grpcx.Server.NewConfig()
  2. c.Options = append(c.Options, []grpc.ServerOption{
  3. grpcx.Server.ChainUnary(
  4. grpcx.Server.UnaryValidate,
  5. )}...,
  6. )
  7. s := grpcx.Server.New(c)
  8. user.Register(s)
  9. s.Run()

客户端

使用grpcx.Client.ChainUnary增加额外的服务端拦截器:

  1. conn = grpcx.Client.MustNewGrpcClientConn("demo", grpcx.Client.ChainUnary(
  2. grpcx.Client.UnaryTracing,
  3. ))

拦截器列表

框架的grpcx组件提供了一系列的常用拦截器,部分内置,部分可选择插拔使用。

拦截器使用部位是否内置描述
UnaryError客户端支持框架错误处理组件。
UnaryTracing客户端支持链路跟踪。
StreamTracing客户端支持链路跟踪(长连接)。
UnaryError服务端支持框架错误处理组件。
UnaryRecover服务端支持服务端panic自动捕获不崩溃。
UnaryAllowNilRes服务端支持nilRes对象返回。
UnaryValidate服务端-支持框架的自动错误校验,基于结构体标签。需要手动引入。
UnaryTracing服务端支持链路跟踪。
StreamTracing服务端支持链路跟踪(长连接)。