gRPC 是一个高性能、通用的开源 RPC 框架。
protoc 用于编译.proto
文件。
下载地址:https://github.com/protocolbuffers/protobuf/releases
下载最新版本就可以了,然后把解压后的protoc-21.8-win64\bin
配置到环境变量。
protoc --version
查看是否成功
demo项目结构如下:
grpc_demo/
├── client.go - 客户端代码
├── go.mod - go模块配置文件
├── proto - 协议目录
│ ├── hello.pb.go - rpc协议go版本代码
│ └── hello.proto - rpc协议文件
└── server.go - rpc服务端代码
项目初始化:
go mod init demo_grpc
安装grpc
包:
go get google.golang.org/grpc
定义服务:
proto/hello.proto
syntax = "proto3";
//option go_package = "path;name";
//path 表示生成的go文件的存放地址,会自动生成目录的。
//name 表示生成的go文件所属的包名
option go_package="./;proto";
// 定义包名
package proto;
// 定义Greeter服务
service Greeter {
// 定义SayHello方法,接受HelloRequest消息, 并返回HelloReply消息
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
// 定义HelloRequest消息
message HelloRequest {
// name字段
string name = 1;
}
// 定义HelloReply消息
message HelloReply {
// message字段
string message = 1;
}
编译命令
项目根目录,执行命令
protoc -I proto/ --go_out=plugins=grpc:proto proto/hello.proto
protoc命令参数说明:
hello.pb.go
文件,里面包含了,我们的服务和接口定义。服务端
package main
import (
"log"
"net"
"golang.org/x/net/context"
// 导入grpc包
"google.golang.org/grpc"
// 导入刚才我们生成的代码所在的proto包。
pb "demo_grpc/proto"
)
// 定义server,用来实现proto文件,里面实现的Greeter服务里面的接口
type server struct{}
// 实现SayHello接口
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
// 创建一个HelloReply消息,设置Message字段,然后直接返回。
return &pb.HelloReply{Message: "Hello " + in.Name}, nil
}
func main() {
// 监听127.0.0.1:50051地址
lis, err := net.Listen("tcp", "127.0.0.1:50051")
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
// 实例化grpc服务端
s := grpc.NewServer()
// 在gRPC服务器注册我们的服务
pb.RegisterGreeterServer(s, &server{})
// 启动grpc服务
err = s.Serve(lis)
if err != nil {
log.Fatalf("启动失败: %v", err)
}
}
客户端
package main
import (
"log"
"golang.org/x/net/context"
// 导入grpc包
"google.golang.org/grpc"
// 导入刚才我们生成的代码所在的proto包。
pb "demo_grpc/proto"
)
func main() {
// 连接grpc服务器
conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
if err != nil {
log.Fatalf("未连接: %v", err)
}
// 延迟关闭连接
defer conn.Close()
// 建立gRPC连接
c := pb.NewGreeterClient(conn)
req := pb.HelloRequest{Name: "world"}
// 调用SayHello接口,发送一条消息
r, err := c.SayHello(context.Background(), &req)
if err != nil {
log.Fatalf("发送消息失败: %v", err)
}
// 打印服务的返回的消息
log.Printf("返回的消息: %s", r.Message)
}
点击下载demo