1.安装接口设计语言 Protocol buffer 的编译器 protoc
下载安装文件
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.13.0/protobuf-all-3.13.0.zip
解压缩
unzip protobuf-all-3.13.0.zip
检查
cd protobuf-all-3.13.0
./configure
编译
make
安装
make install
安装成功后执行protoc --version出现报错:
protoc: error while loading shared libraries: libprotobuf.so.24: cannot open shared object file: No such file or directory
在protoc目录下执行:ldconfig。就能解决了。
2.执行 go install 命令安装插件:
go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.26
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.1
3.修改PATH
export PATH="$PATH:$(go env GOPATH)/bin"
4.创建项目的目录。
grpc为根目录,下面有三个子目录:pb,client,service。
5.编写 .proto 文件
在 Golang 语言中使用 gRPC,首先编写 .proto 文件,然后使用 protoc 编译 .proto 文件生成 pb 文件,最后编写剩余的 Golang 代码。
syntax = "proto3";
option go_package = "grpc/pb";
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}
6.使用 protoc 编译 .proto 文件,生成 pb 文件。(在grpc/pb/目录下执行)
protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative ./helloworld.proto
执行完成后就会在pb目录下新增了两个文件:
7.编写服务端和客户端 Golang 代码
在service目录下新增service.go文件,服务端示例代码:
package main
import (
"context"
"google.golang.org/grpc"
"log"
"net"
pb "grpc/pb"
)
const (
port = ":50051"
)
type server struct {
pb.UnimplementedGreeterServer
}
func (s *server) 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,监听 TCP 端口
lis, err := net.Listen("tcp", port)
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
//创建 gRPC Server对象
s := grpc.NewServer()
//将 GreeterServer(其包含需要被调用的服务端接口)注册到gRPC Server 的内部注册中心
//这样可以在接受到请求时,通过内部的服务发现,发现该服务端接口并转接进行逻辑处理
pb.RegisterGreeterServer(s, &server{})
log.Printf("server listening at %v", lis.Addr())
//gRPC Server开始 lis.Accept,直到 Stop 或 GracefulStop
if err := s.Serve(lis); err != nil {
log.Fatalf("failed to serve: %v", err)
}
}
在client目录下新增client.go文件。客户端代码示例:
package main
import (
"context"
"google.golang.org/grpc"
"log"
"os"
"time"
pb "grpc/pb"
)
const (
address = ":50051"
defaultName = "word"
)
func main() {
//连接grpc server
conn, err := grpc.Dial(address, grpc.WithInsecure(), grpc.WithBlock())
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
//创建 GreeterService 的客户端对象
c := pb.NewGreeterClient(conn)
name := defaultName
if len(os.Args) > 1 {
name = os.Args[1]
}
ctx, cancel := context.WithTimeout(context.Background(), time.Second)
defer cancel()
//发送 RPC 请求,等待同步响应,得到回调后返回响应结果
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())
}
8.使用go mod下载相关依赖
在grpc目录下执行:
#初始化项目
go mod init grpc
#整理依赖包
go mod tidy
9.开始测试