grpc的拦截器主要实现中间信息获取和统一错误处理,类似于java的filter
    拦截器有两种,流式、非流式
    非流式的函数签名:
    func unaryInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error)
    流式的函数签名
    参考:https://github.com/grpc/grpc-go/tree/master/examples/features/interceptor
    服务端代码示例:

    1. package main
    2. import (
    3. "context"
    4. "flag"
    5. "fmt"
    6. "io"
    7. "log"
    8. "net"
    9. "strings"
    10. "time"
    11. "google.golang.org/grpc"
    12. "google.golang.org/grpc/codes"
    13. "google.golang.org/grpc/credentials"
    14. ecpb "google.golang.org/grpc/examples/features/proto/echo"
    15. "google.golang.org/grpc/metadata"
    16. "google.golang.org/grpc/status"
    17. "google.golang.org/grpc/testdata"
    18. )
    19. var (
    20. port = flag.Int("port", 50051, "the port to serve on")
    21. errMissingMetadata = status.Errorf(codes.InvalidArgument, "missing metadata")
    22. errInvalidToken = status.Errorf(codes.Unauthenticated, "invalid token")
    23. )
    24. // logger is to mock a sophisticated logging system. To simplify the example, we just print out the content.
    25. func logger(format string, a ...interface{}) {
    26. fmt.Printf("LOG:\t"+format+"\n", a...)
    27. }
    28. //实现接口----------
    29. type server struct{}
    30. func (s *server) UnaryEcho(ctx context.Context, in *ecpb.EchoRequest) (*ecpb.EchoResponse, error) {
    31. fmt.Printf("unary echoing message %q\n", in.Message)
    32. return &ecpb.EchoResponse{Message: in.Message}, nil
    33. }
    34. func (s *server) ServerStreamingEcho(in *ecpb.EchoRequest, stream ecpb.Echo_ServerStreamingEchoServer) error {
    35. return status.Error(codes.Unimplemented, "not implemented")
    36. }
    37. func (s *server) ClientStreamingEcho(stream ecpb.Echo_ClientStreamingEchoServer) error {
    38. return status.Error(codes.Unimplemented, "not implemented")
    39. }
    40. func (s *server) BidirectionalStreamingEcho(stream ecpb.Echo_BidirectionalStreamingEchoServer) error {
    41. for {
    42. in, err := stream.Recv()
    43. if err != nil {
    44. if err == io.EOF {
    45. return nil
    46. }
    47. fmt.Printf("server: error receiving from stream: %v\n", err)
    48. return err
    49. }
    50. fmt.Printf("bidi echoing message %q\n", in.Message)
    51. stream.Send(&ecpb.EchoResponse{Message: in.Message})
    52. }
    53. }
    54. //实现接口------------
    55. // valid validates the authorization.
    56. func valid(authorization []string) bool {
    57. if len(authorization) < 1 {
    58. return false
    59. }
    60. token := strings.TrimPrefix(authorization[0], "Bearer ")
    61. // Perform the token validation here. For the sake of this example, the code
    62. // here forgoes any of the usual OAuth2 token validation and instead checks
    63. // for a token matching an arbitrary string.
    64. return token == "some-secret-token"
    65. }
    66. //非流式的拦截器
    67. func unaryInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
    68. // authentication (token verification)
    69. md, ok := metadata.FromIncomingContext(ctx)
    70. if !ok {
    71. return nil, errMissingMetadata
    72. }
    73. if !valid(md["authorization"]) {
    74. return nil, errInvalidToken
    75. }
    76. m, err := handler(ctx, req)
    77. if err != nil {
    78. logger("RPC failed with error %v", err)
    79. }
    80. return m, err
    81. }
    82. // wrappedStream wraps around the embedded grpc.ServerStream, and intercepts the RecvMsg and
    83. // SendMsg method call.
    84. type wrappedStream struct {
    85. grpc.ServerStream
    86. }
    87. func (w *wrappedStream) RecvMsg(m interface{}) error {
    88. logger("Receive a message (Type: %T) at %s", m, time.Now().Format(time.RFC3339))
    89. return w.ServerStream.RecvMsg(m)
    90. }
    91. func (w *wrappedStream) SendMsg(m interface{}) error {
    92. logger("Send a message (Type: %T) at %v", m, time.Now().Format(time.RFC3339))
    93. return w.ServerStream.SendMsg(m)
    94. }
    95. func newWrappedStream(s grpc.ServerStream) grpc.ServerStream {
    96. return &wrappedStream{s}
    97. }
    98. func streamInterceptor(srv interface{}, ss grpc.ServerStream, info *grpc.StreamServerInfo, handler grpc.StreamHandler) error {
    99. // authentication (token verification)
    100. md, ok := metadata.FromIncomingContext(ss.Context())
    101. if !ok {
    102. return errMissingMetadata
    103. }
    104. if !valid(md["authorization"]) {
    105. return errInvalidToken
    106. }
    107. err := handler(srv, newWrappedStream(ss))
    108. if err != nil {
    109. logger("RPC failed with error %v", err)
    110. }
    111. return err
    112. }
    113. func main() {
    114. flag.Parse()
    115. lis, err := net.Listen("tcp", fmt.Sprintf(":%d", *port))
    116. if err != nil {
    117. log.Fatalf("failed to listen: %v", err)
    118. }
    119. // Create tls based credential.
    120. creds, err := credentials.NewServerTLSFromFile(testdata.Path("server1.pem"), testdata.Path("server1.key"))
    121. if err != nil {
    122. log.Fatalf("failed to create credentials: %v", err)
    123. }
    124. s := grpc.NewServer(grpc.Creds(creds), grpc.UnaryInterceptor(unaryInterceptor), grpc.StreamInterceptor(streamInterceptor))
    125. // Register EchoServer on the server.
    126. ecpb.RegisterEchoServer(s, &server{})
    127. if err := s.Serve(lis); err != nil {
    128. log.Fatalf("failed to serve: %v", err)
    129. }
    130. }
    1. package main
    2. import (
    3. "context"
    4. "flag"
    5. "fmt"
    6. "io"
    7. "log"
    8. "time"
    9. "golang.org/x/oauth2"
    10. "google.golang.org/grpc"
    11. "google.golang.org/grpc/credentials"
    12. "google.golang.org/grpc/credentials/oauth"
    13. ecpb "google.golang.org/grpc/examples/features/proto/echo"
    14. "google.golang.org/grpc/testdata"
    15. )
    16. var addr = flag.String("addr", "localhost:50051", "the address to connect to")
    17. const fallbackToken = "some-secret-token"
    18. // logger is to mock a sophisticated logging system. To simplify the example, we just print out the content.
    19. func logger(format string, a ...interface{}) {
    20. fmt.Printf("LOG:\t"+format+"\n", a...)
    21. }
    22. // unaryInterceptor is an example unary interceptor.
    23. func unaryInterceptor(ctx context.Context, method string, req, reply interface{}, cc *grpc.ClientConn, invoker grpc.UnaryInvoker, opts ...grpc.CallOption) error {
    24. var credsConfigured bool
    25. for _, o := range opts {
    26. _, ok := o.(grpc.PerRPCCredsCallOption)
    27. if ok {
    28. credsConfigured = true
    29. break
    30. }
    31. }
    32. if !credsConfigured {
    33. opts = append(opts, grpc.PerRPCCredentials(oauth.NewOauthAccess(&oauth2.Token{
    34. AccessToken: fallbackToken,
    35. })))
    36. }
    37. start := time.Now()
    38. err := invoker(ctx, method, req, reply, cc, opts...)
    39. end := time.Now()
    40. logger("RPC: %s, start time: %s, end time: %s, err: %v", method, start.Format("Basic"), end.Format(time.RFC3339), err)
    41. return err
    42. }
    43. // wrappedStream wraps around the embedded grpc.ClientStream, and intercepts the RecvMsg and
    44. // SendMsg method call.
    45. type wrappedStream struct {
    46. grpc.ClientStream
    47. }
    48. func (w *wrappedStream) RecvMsg(m interface{}) error {
    49. logger("Receive a message (Type: %T) at %v", m, time.Now().Format(time.RFC3339))
    50. return w.ClientStream.RecvMsg(m)
    51. }
    52. func (w *wrappedStream) SendMsg(m interface{}) error {
    53. logger("Send a message (Type: %T) at %v", m, time.Now().Format(time.RFC3339))
    54. return w.ClientStream.SendMsg(m)
    55. }
    56. func newWrappedStream(s grpc.ClientStream) grpc.ClientStream {
    57. return &wrappedStream{s}
    58. }
    59. // streamInterceptor is an example stream interceptor.
    60. func streamInterceptor(ctx context.Context, desc *grpc.StreamDesc, cc *grpc.ClientConn, method string, streamer grpc.Streamer, opts ...grpc.CallOption) (grpc.ClientStream, error) {
    61. var credsConfigured bool
    62. for _, o := range opts {
    63. _, ok := o.(*grpc.PerRPCCredsCallOption)
    64. if ok {
    65. credsConfigured = true
    66. }
    67. }
    68. if !credsConfigured {
    69. opts = append(opts, grpc.PerRPCCredentials(oauth.NewOauthAccess(&oauth2.Token{
    70. AccessToken: fallbackToken,
    71. })))
    72. }
    73. s, err := streamer(ctx, desc, cc, method, opts...)
    74. if err != nil {
    75. return nil, err
    76. }
    77. return newWrappedStream(s), nil
    78. }
    79. func callUnaryEcho(client ecpb.EchoClient, message string) {
    80. ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    81. defer cancel()
    82. resp, err := client.UnaryEcho(ctx, &ecpb.EchoRequest{Message: message})
    83. if err != nil {
    84. log.Fatalf("client.UnaryEcho(_) = _, %v: ", err)
    85. }
    86. fmt.Println("UnaryEcho: ", resp.Message)
    87. }
    88. func callBidiStreamingEcho(client ecpb.EchoClient) {
    89. ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    90. defer cancel()
    91. c, err := client.BidirectionalStreamingEcho(ctx)
    92. if err != nil {
    93. return
    94. }
    95. for i := 0; i < 5; i++ {
    96. if err := c.Send(&ecpb.EchoRequest{Message: fmt.Sprintf("Request %d", i+1)}); err != nil {
    97. log.Fatalf("failed to send request due to error: %v", err)
    98. }
    99. }
    100. c.CloseSend()
    101. for {
    102. resp, err := c.Recv()
    103. if err == io.EOF {
    104. break
    105. }
    106. if err != nil {
    107. log.Fatalf("failed to receive response due to error: %v", err)
    108. }
    109. fmt.Println("BidiStreaming Echo: ", resp.Message)
    110. }
    111. }
    112. func main() {
    113. flag.Parse()
    114. // Create tls based credential.
    115. creds, err := credentials.NewClientTLSFromFile(testdata.Path("ca.pem"), "x.test.youtube.com")
    116. if err != nil {
    117. log.Fatalf("failed to load credentials: %v", err)
    118. }
    119. // Set up a connection to the server.
    120. conn, err := grpc.Dial(*addr, grpc.WithTransportCredentials(creds), grpc.WithUnaryInterceptor(unaryInterceptor), grpc.WithStreamInterceptor(streamInterceptor))
    121. if err != nil {
    122. log.Fatalf("did not connect: %v", err)
    123. }
    124. defer conn.Close()
    125. // Make a echo client and send RPCs.
    126. rgc := ecpb.NewEchoClient(conn)
    127. callUnaryEcho(rgc, "hello world")
    128. callBidiStreamingEcho(rgc)
    129. }