grpc实战(1)简单实现helloworld
1、创建项目grpc_demo文件架构,项目架构如下:

2、在helloworld文件夹下创建hello_world.proto文件,内容如下:
//声明proto的版本 只有 proto3 才支持 gRPC
syntax = "proto3";
// 将编译后文件输出在 github.com/lixd/grpc-go-example/helloworld/helloworld 目录
option go_package = "github.com/lixd/grpc-go-example/helloworld/helloworld";
// 指定当前proto文件属于helloworld包
package helloworld;
// 定义一个名叫 greeting 的服务
service Greeter {
// 该服务包含一个 SayHello 方法 HelloRequest、HelloReply分别为该方法的输入与输出
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
// 具体的参数定义
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}
3、在helloworld目录下运行如下命令:
protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative ./hello_world.proto
此时,helloworld文件下会出现后缀为pb.go和_grpc.pb.go的两个文件。
4、编写server代码:
具体步骤如下:
- 1)定义一个结构体,必须包含
pb.UnimplementedGreeterServer对象; - 2)实现 .proto文件中定义的API;
- 3)将服务描述及其具体实现注册到 gRPC 中;
- 4)在server目录下分别运行命令go mod init server、go mod tidy;
- 5)启动服务。
package main
import (
"context"
"log"
"net"
pb "github.com/lixd/grpc-go-example/helloworld/helloworld"
"google.golang.org/grpc"
)
const (
port = ":50051"
)
// greeterServer 定义一个结构体用于实现 .proto文件中定义的方法
// 新版本 gRPC 要求必须嵌入 pb.UnimplementedGreeterServer 结构体
type greeterServer struct {
pb.UnimplementedGreeterServer
}
// SayHello 简单实现一下.proto文件中定义的 SayHello 方法
func (g *greeterServer) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
log.Printf("Received: %v", in.GetName())
return &pb.HelloReply{Message: "Hello " + in.GetName()}, nil
}
func main() {
listen, err := net.Listen("tcp", port)
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
s := grpc.NewServer()
// 将服务描述(server)及其具体实现(greeterServer)注册到 gRPC 中去.
// 内部使用的是一个 map 结构存储,类似 HTTP server。
pb.RegisterGreeterServer(s, &greeterServer{})
log.Println("Serving gRPC on 0.0.0.0" + port)
if err := s.Serve(listen); err != nil {
log.Fatalf("failed to serve: %v", err)
}
}
5、编写client代码:
具体步骤如下:
- 1)首先使用
grpc.Dial()与 gRPC 服务器建立连接; - 2)使用
pb.NewGreeterClient(conn)获取客户端; - 3)通过客户端调用ServiceAPI方法
client.SayHello。 - 4)在client目录下分别运行命令go mod init client、go mod tidy;
- 5)运行客户端。
package main
import (
"context"
"log"
"os"
"time"
pb "github.com/lixd/grpc-go-example/helloworld/helloworld"
"google.golang.org/grpc"
)
const (
address = "localhost:50051"
defaultName = "world"
)
func main() {
conn, err := grpc.Dial(address, grpc.WithInsecure(), grpc.WithBlock())
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
c := pb.NewGreeterClient(conn)
// 通过命令行参数指定 name
name := defaultName
if len(os.Args) > 1 {
name = os.Args[1]
}
ctx, cancel := context.WithTimeout(context.Background(), time.Second)
defer cancel()
r, err := c.SayHello(ctx, &pb.HelloRequest{Name: name})
if err != nil {
log.Fatalf("could not greet: %v", err)
}
log.Printf("Greeting: %s", r.GetMessage())
}
参考:(29条消息) 史上最细gRPC(Go)入门教程(二)---gRPC初体验--hello world_指月小筑的博客-CSDN博客

浙公网安备 33010602011771号