当 gRPC 客户端调用服务端方法时,以下是大致的过程:
- 准备请求: 客户端创建一个包含所需参数的请求消息,并将其序列化为字节流。这通常是通过 Protocol Buffers(ProtoBuf)来完成的,因为 gRPC 使用 ProtoBuf 作为默认的消息序列化机制。
- 建立连接: 客户端与服务端建立连接。在 gRPC 中,连接通常基于 HTTP/2 协议,因此客户端与服务端之间的通信是通过 HTTP/2 连接进行的。
- 发送请求: 客户端将序列化的请求消息发送给服务端。这个请求通过底层的 HTTP/2 连接发送。
- 服务端处理请求: 服务端接收到请求消息后,根据客户端请求的方法调用相应的服务端方法。服务端执行这个方法,并生成一个响应消息。
- 返回响应: 服务端将响应消息序列化为字节流,并通过 HTTP/2 连接发送回客户端。
- 接收响应: 客户端接收到响应消息后,将其反序列化为对象。客户端可以从响应中提取所需的数据。
- 关闭连接: 当请求-响应交换完成后,客户端和服务端可以选择关闭连接以释放资源。在某些情况下,连接可能会被保持以供后续请求复用。
下面是一个简单的 gRPC 实例
- 首先,我们定义一个简单的 .proto 文件来描述我们的服务和消息类型:
syntax = "proto3";
// 定义服务
service Greeter {
// 定义方法
rpc SayHello (HelloRequest) returns (HelloResponse) {}
}
// 定义请求消息类型
message HelloRequest {
string name = 1;
}
// 定义响应消息类型
message HelloResponse {
string message = 1;
}
- 然后使用 Protocol Buffers 工具生成对应的服务和消息类:
protoc --proto_path=. --go_out=. --go-grpc_out=. example.proto
- 接着实现服务端和客户端的代码:
- 服务端:
package main
import (
"context"
"fmt"
"log"
"net"
pb "your_package_name" // 根据生成的代码导入对应的包
"google.golang.org/grpc"
)
// 实现 Greeter 服务
type server struct{}
// 实现 SayHello 方法
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloResponse, error) {
log.Printf("Received: %v", in.Name)
return &pb.HelloResponse{Message: "Hello " + in.Name}, nil
}
func main() {
lis, err := net.Listen("tcp", ":50051")
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
s := grpc.NewServer()
pb.RegisterGreeterServer(s, &server{})
fmt.Println("gRPC server started on port 50051")
if err := s.Serve(lis); err != nil {
log.Fatalf("failed to serve: %v", err)
}
}
- 客户端:
package main
import (
"context"
"fmt"
"log"
pb "your_package_name" // 根据生成的代码导入对应的包
"google.golang.org/grpc"
)
func main() {
// 连接 gRPC 服务
conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
c := pb.NewGreeterClient(conn)
// 调用服务方法
name := "World"
r, err := c.SayHello(context.Background(), &pb.HelloRequest{Name: name})
if err != nil {
log.Fatalf("could not greet: %v", err)
}
fmt.Printf("Response: %s\n", r.Message)
}
将 “your_package_name” 替换为您在 .proto 文件中定义的包名称,并根据需要替换端口号和其他参数。