如何搭建简单的 gRPC 服务 - 从零开始

介绍

gRPC 是一个高性能、开源和通用的 RPC 框架，由 Google 开发。在这篇文章中，我们将学习如何搭建一个简单的 gRPC 服务，以及如何与之交互。

步骤

1. 安装 gRPC 和 Protobuf

首先，我们需要安装 gRPC 和 Protobuf。你可以访问 gRPC 官方文档 来获取详细的安装步骤。

2. 编写 Protobuf 文件

创建一个名为 example.proto 的文件，定义你的服务和消息。示例内容如下：

protobuf

复制

syntax = "proto3"; package example; service Greeter { rpc SayHello (HelloRequest) returns (HelloResponse) {} } message HelloRequest { string name = 1; } message HelloResponse { string message = 1; }

3. 生成 gRPC 代码

使用 Protobuf 编译器生成 gRPC 代码。运行以下命令：

bash

复制

protoc --go_out=plugins=grpc:. example.proto

4. 编写服务端代码

创建一个名为 server.go 的文件，实现服务端代码。示例代码如下：

go

复制

package main import ( "context" "log" "net" pb "your_package_path/example" "google.golang.org/grpc" ) type server struct{} func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloResponse, error) { 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{}) if err := s.Serve(lis); err != nil { log.Fatalf("failed to serve: %v", err) } }

5. 编写客户端代码

创建一个名为 client.go 的文件，实现客户端代码。示例代码如下：

go

复制

package main import ( "context" "log" pb "your_package_path/example" "google.golang.org/grpc" ) func main() { 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) r, err := c.SayHello(context.Background(), &pb.HelloRequest{Name: "Alice"}) if err != nil { log.Fatalf("could not greet: %v", err) } log.Printf("Greeting: %s", r.Message) }

6. 运行服务端和客户端

在命令行中分别运行服务端和客户端代码：

bash

复制

go run server.go

bash

复制

go run client.go

你应该能够看到客户端输出 Greeting: Hello, Alice。

结论

恭喜！你已经成功搭建了一个简单的 gRPC 服务，并实现了基本的交互。希望这篇文章对你有所帮助！