gRPC中的metadata是什么？有什么作用？

gRPC中的metadata是什么？

gRPC中的Metadata类似于HTTP Header的概念，用于描述数据和消息的数据信息，可以理解为一个键值对集合，用于在gRPC客户端和服务端之间传递元数据信息，提供一种在消息中传递数据和追加关键信息的机制。

Metadata主要有两个作用：

1. 提供RPC调用的元数据信息，例如用于链路追踪的traceId、调用时间、应用版本等等。

2. 控制gRPC消息的格式，例如是否压缩或是否加密。

在gRPC中，元数据可以在客户端和服务器之间进行交换。客户端可以在发送请求时，通过添加元数据，向服务器传递特定的信息，例如授权令牌、用户标识、链路追踪ID等。服务器可以使用这些元数据来进行身份验证、授权、跟踪请求等操作。

使用gRPC的元数据可以通过gRPC API提供的Metadata对象来实现。在客户端，可以在调用服务方法时使用Metadata对象，并将元数据添加到对象中，服务端可以在接收请求时从RPC上下文中提取Metadata。

使用场景示例

下面举一个例子，使用 Golang 代码来演示。在 Golang 中使用的Metadata是一个类型为map[string]string的数据结构，其中的键值对表示元数据的key和value。

import (
    "golang.org/x/net/context"
    "google.golang.org/grpc/metadata"
)

// SendRequestWithContext 发送请求的方法，需要传入一个context对象和metadata
func SendRequestWithContext(ctx context.Context, data []byte, md metadata.MD) {
	  // client实例
    client := pb.NewExampleClient(conn)
    // 通过ctx传入metadata
    resp, err := client.ExampleMethod(ctx, &pb.ExampleRequest{Data: data}, grpc.Header(md))
    if err != nil {
        log.Fatalf("Send request failed: %v", err)
    }
    log.Printf("Response: %v", resp.GetData())
}

在上述示例中，使用了metadata.MD作为第三个参数，将元数据发送给服务端。下面是发送请求时创建metadata的示例：

ctx := context.Background()
md := metadata.New(map[string]string{"authorization": "Bearer <user-token>"})
ctx = metadata.NewOutgoingContext(ctx, md)

data := []byte("example request data")
SendRequestWithContext(ctx, data, md)

在上述示例中，使用metadata.New创建Metadata对象，用于包装元数据。然后使用metadata.NewOutgoingContext创建一个新的context，将Metadata对象附加到其中。最后，将新的context和元数据传递给SendRequestWithContext方法，以便将元数据发送到服务端。

在服务端接收元数据时，可以通过context对象的Value方法获取到metadata.MD，然后从中获取保存的键值对。以下是服务端代码中获取元数据的示例：

func (s *server) ExampleMethod(ctx context.Context, req *pb.ExampleRequest) (*pb.ExampleResponse, error) {
    // 从context中获取metadata
    md, ok := metadata.FromIncomingContext(ctx)
    if ok {
        // 获取key对应的value
        token := md.Get("authorization")
        // 处理元数据
        ...
    }
    // 处理请求
    ...
}

通过在服务端的方法中获取metadata.MD类型的值，就可以获取到客户端请求的元数据，并使用这些元数据进行后续操作。

小结

总之，gRPC的Metadata是一种用于在gRPC客户端和服务器之间传递元数据信息的机制，可以提供有关RPC调用的信息以及控制gRPC消息的格式。