gRPC(Google Remote Procedure Call)是一个由Google开发的高性能、开源RPC(远程过程调用)框架。它基于HTTP/2进行数据传输,使用ProtoBuf(Protocol Buffers)作为接口描述语言,支持多种编程语言,如Java、Go、C#等,适用于不同语言环境。gRPC的显著特点包括其高效的通信性能,支持双向流、多路复用和二进制传输,以及集成的安全机制,如SSL/TLS。这些特性使gRPC特别适合用于构建高性能的分布式系统和微服务架构中的服务间通信,尤其在需要处理大量数据和高吞吐量的场景中表现出色。
确保安装了最新版本的Go。All releases - The Go Programming Language
https://github.com/protocolbuffers/protobuf/releases/download/v25.1/protobuf-25.1.zip
下载适用于Windows的protoc-<version>.zip
文件。
如果上面链接失效请访问官网地址:https://github.com/protocolbuffers/protobuf/releases
解压下载的文件到一个你选择的目录。
将解压后的bin
目录添加到你的环境变量PATH
中。这样可以从任意位置运行protoc
。
PATH
,点击“编辑”。bin
目录的路径,点击“确定”。在 macOS 上,你可以使用 Homebrew 来安装 protoc:
brew install protobuf
ProtoBuf编译器用于编译.proto
文件。
对于大多数基于Debian的Linux发行版(如Ubuntu),你可以使用以下命令安装:
sudo apt-get install protobuf-compiler
?对于基于RPM的发行版(如Fedora、CentOS),你可以使用:
sudo dnf install protobuf-compiler
安装完成后,你可以在命令行中运行以下命令来验证安装:
protoc --version
通过go get
安装gRPC的Go实现的包。
go get -u google.golang.org/grpc
go get -u google.golang.org/protobuf/cmd/protoc-gen-go \
google.golang.org/grpc/cmd/protoc-gen-go-grpc
创建Proto文件:定义服务接口和消息格式。例如,创建helloworld.proto
。
syntax = "proto3";
package helloworld;
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}
使用ProtoBuf编译器生成Go代码。
protoc --go_out=. --go_opt=paths=source_relative \
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
helloworld/helloworld.proto
package main
import (
"context"
"log"
"net"
"google.golang.org/grpc"
pb "path/to/your/service"
)
type server struct {
pb.UnimplementedGreeterServer
}
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
return &pb.HelloReply{Message: "Hello " + in.GetName()}, 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)
}
}
package main
import (
"context"
"log"
"time"
"google.golang.org/grpc"
pb "path/to/your/service"
)
func main() {
conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure(), grpc.WithBlock())
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
c := pb.NewGreeterClient(conn)
name := "world"
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())
}
运行服务器和客户端,确保它们能够相互通信。