gRPC 初探
- 前言
- 安裝
- 使用
- 參考
前言
gRPC 出來很久了,很多地方都在使用中。因為是google 出品的所以一直受到很大的關注。
在實際的學習中,和其他的rpc框架還是有些特點:
- 跨語言,如果專案是跨語言通訊的可以考慮使用gRPC。
- gRPC 基於 HTTP/2 標準設計,使其在移動裝置上表現更好,更省電和節省空間佔用。
- 通訊格式預設使用protocolbuffer(是google 的一種資料交換的格式,它獨立於語言,獨立於平臺),二進位制,效能好,現在使用 proto3的新風格。
下面是使用中的一些筆記,已 golang 為基礎
安裝
我們先安裝gRPC-Go:
#直接使用 get 安裝,原始碼中包括了後面的examples
go get -u google.golang.org/grpc
現在還不能使用gRPC,還需要安裝前面提到的protocolbuffer
protocolbuffer 安裝,golang需要編譯安裝
git clone git@github.com:google/protobuf.git
cd protobuf/
#以防萬一
brew install autoconf automake libtool
./autogen.sh
./configure
make
make check
sudo make install
#驗證,命令
protoc
安裝go的protobuf外掛
#安裝,提供golang執行protobuf的環境和go服務端原始碼生成功能(?)
go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
#protoc-gen-go 命令需要直接能被執行到
export PATH=$PATH:$GOPATH/bin
使用
目錄結構
helloworld/helloworld.proto
此為 protobuf 的IDL,定義了rpc服務的具體內容,內容不做解釋了
helloworld/helloworld.pb.go
此為根據 helloworld.proto 生成golang的protobuf定義檔案,客戶端服務端同時需要引入並使用
我們直接看例子,先跑起來
#第一個例子目錄
cd GOPAHT/src/google.golang.org/grpc/examples/helloworld
#執行go 服務端
go run greeter_server/main.go
#執行go 客戶端
go run greeter_client/main.go haha
#客戶端返回內容,成功!
2017/10/10 01:09:24 Greeting: Hello haha
使用程式碼生成外掛
#修改proto檔案時,需要使用命令重現生成go的protobuf依賴檔案
protoc -I helloworld/ helloworld/helloworld.proto --go_out=plugins=grpc:helloworld
修改我們的helloworld程式碼
下面我們修改下helloworld程式碼在完整的試一試
helloworld/helloworld.proto
package helloworld;
// The greeting service definition.
service Greeter {
// Sends a greeting
rpc SayHello (HelloRequest) returns (HelloReply) {}
// Sends another greeting
//我們新增了 SayHelloAgain rpc 方法
rpc SayHelloAgain (HelloRequest) returns (HelloReply) {}
}
// The request message containing the user`s name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}
greeter_server/main.go
type server struct{}
// SayHello implements helloworld.GreeterServer
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
return &pb.HelloReply{Message: "Hello " + in.Name}, nil
}
//我們對應增加了 服務端的 支援 SayHelloAgain
func (s *server) SayHelloAgain(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
return &pb.HelloReply{Message: "Hello again " + in.Name}, nil
}
func main() {
lis, err := net.Listen("tcp", port)
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
s := grpc.NewServer()
pb.RegisterGreeterServer(s, &server{})
// Register reflection service on gRPC server.
reflection.Register(s)
if err := s.Serve(lis); err != nil {
log.Fatalf("failed to serve: %v", err)
}
}
func main() {
// Set up a connection to the server.
conn, err := grpc.Dial(address, grpc.WithInsecure())
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
c := pb.NewGreeterClient(conn)
// Contact the server and print out its response.
name := defaultName
if len(os.Args) > 1 {
name = os.Args[1]
}
r, err := c.SayHello(context.Background(), &pb.HelloRequest{Name: name})
if err != nil {
log.Fatalf("could not greet: %v", err)
}
log.Printf("Greeting: %s", r.Message)
//我們又加了 客戶端 的呼叫邏輯
r, err = c.SayHelloAgain(context.Background(), &pb.HelloRequest{Name: name})
if err != nil {
log.Fatalf("could not greet: %v", err)
}
log.Printf("Greeting: %s", r.Message)
}
#使用protoc 重現生成 protobuf依賴檔案
protoc -I helloworld/ helloworld/helloworld.proto --go_out=plugins=grpc:helloworld
#執行驗證
go run greeter_client/main.go haha
#返回,呼叫了兩次rpc
2017/10/10 01:48:20 Greeting: Hello haha
2017/10/10 01:48:20 Greeting: Hello again haha
這就是gRPC初探,後面會寫一篇php做為客戶端使用gRPC的小文章。