gRPC 初探

df007df發表於2019-02-16

gRPC 初探

  • 前言
  • 安裝
  • 使用
  • 參考

前言

gRPC 出來很久了,很多地方都在使用中。因為是google 出品的所以一直受到很大的關注。

在實際的學習中,和其他的rpc框架還是有些特點:

  1. 跨語言,如果專案是跨語言通訊的可以考慮使用gRPC。
  2. gRPC 基於 HTTP/2 標準設計,使其在移動裝置上表現更好,更省電和節省空間佔用。
  3. 通訊格式預設使用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的小文章。


參考