[シリーズ]ゴーgRPCのHello World

アウトライン

GRPC初め、この記事gRPC、出力のHello Worldを使用することを学びます。

• ゴー機能付きサーバーgRPCを実装します。
• 実現gRPCクライアントと移動します。

gRPCは、サービスメソッドの4種類をサポートしており、今回は、個々のRPCサーバー側のストリーミングRPCを実現します。

サービスメソッドの4つのカテゴリ

個々のRPC

サーバーは、通常の関数呼び出しのように、サーバーに要求を送信し、サーバからの応答を取得します。

rpc SayHello(HelloRequest) returns (HelloResponse){}

RPCサーバーストリーミング

クライアントがサーバに要求を送信し、メッセージを読むために一連のデータの流れを得ることができます。クライアントは、これまでにこれ以上のニュースまで、返されたデータストリームから読み出されました。

rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse){}

ストリーミングクライアントRPC

クライアントデータストリームが書かれており、サーバーに送信された一連のメッセージを備えています。クライアントは、メッセージが書かれて完了すると、それはメッセージを読むためにサーバーを待ってレスポンスを返します。

rpc LotsOfGreetings(stream HelloRequest) returns (HelloResponse) {}

双方向フローRPC

両側が別々にデータを読み書き一連のメッセージを流れる伝送することができます。2つのデータストリームは、操作から独立しているので、クライアントとサーバーが読み取られ、例えば、その所望の任意の順序を書くことができる：サーバは、ライト応答メッセージの前にクライアントのすべてを待つことができるか、またはそれが最初のメッセージを読み取ることができますメッセージ、または読み取りと書き込みの他の組み合わせを記述します。各データストリームのためにメッセージが維持されます。

rpc BidiHello(stream HelloRequest) returns (stream HelloResponse){}

インストール

インストールいるProtobufコンパイラ

brew install protobuf

検証：

protoc --version

//输出：libprotoc 3.7.1

いるProtobufプラグインのインストールを行きます

go get -u github.com/golang/protobuf/proto

go get -u github.com/golang/protobuf/protoc-gen-go

インストールgrpc-行きます

go get -u google.golang.org/grpc

Hello Worldのサービスを書きます

• サーバーの書き込み.protoファイルを
• サーバーの生成.pb.goファイルを、クライアントに同期させます
• 書き込みサーバは、インタフェース・コードを提供します
• クライアントの呼び出しを記述するためのインタフェースコード

ディレクトリ構造

├─ hello  -- 代码根目录
│  ├─ go_client
│     ├── main.go
│     ├── proto
│         ├── hello
│            ├── hello.pb.go
│  ├─ go_server
│     ├── main.go
│     ├── controller
│         ├── hello_controller
│            ├── hello_server.go
│     ├── proto
│         ├── hello
│            ├── hello.pb.go
│            ├── hello.proto

これは、二つのプロジェクトに分割することができgo_server go_clientとポストのためのディレクトリを作成します。

ファイルサーバhello.protoを書きます

syntax = "proto3"; // 指定 proto 版本

package hello;     // 指定包名

// 定义 Hello 服务
service Hello {

    // 定义 SayHello 方法
    rpc SayHello(HelloRequest) returns (HelloResponse) {}

    // 定义 LotsOfReplies 方法
    rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse){}
}

// HelloRequest 请求结构
message HelloRequest {
    string name = 1;
}

// HelloResponse 响应结构
message HelloResponse {
    string message = 1;
}

もっといるProtobuf構文については、以下を参照してください。

https://developers.google.com/protocol-buffers/

ジェネレーションサーバ .pb.go

protoc -I . --go_out=plugins=grpc:. ./hello.proto

生成された一方でhello.pb.go、クライアントにコピーします。

protocを行い、より多くのコマンドパラメータを表示し、オプションを参照してください。

書き込みサーバは、インタフェース・コードを提供します

// hello_server.go
package hello_controller

import (
    "fmt"
    "golang.org/x/net/context"
    "hello/go_server/proto/hello"
)

type HelloController struct{}

func (h *HelloController) SayHello(ctx context.Context, in *hello.HelloRequest) (*hello.HelloResponse, error) {
    return &hello.HelloResponse{Message : fmt.Sprintf("%s", in.Name)}, nil
}

func (h *HelloController) LotsOfReplies(in *hello.HelloRequest, stream hello.Hello_LotsOfRepliesServer)  error {
    for i := 0; i < 10; i++ {
        stream.Send(&hello.HelloResponse{Message : fmt.Sprintf("%s %s %d", in.Name, "Reply", i)})
    }
    return nil
}

// main.go
package main

import (
    "log"
    "net"
    "hello/go_server/proto/hello"
    "hello/go_server/controller/hello_controller"
    "google.golang.org/grpc"
)

const (
    Address = "0.0.0.0:9090"
)

func main() {
    listen, err := net.Listen("tcp", Address)
    if err != nil {
        log.Fatalf("Failed to listen: %v", err)
    }

    s := grpc.NewServer()

    // 服务注册
    hello.RegisterHelloServer(s, &hello_controller.HelloController{})

    log.Println("Listen on " + Address)

    if err := s.Serve(listen); err != nil {
        log.Fatalf("Failed to serve: %v", err)
    }
}

実行します。

go run main.go

2019/07/28 17:51:20 Listen on 0.0.0.0:9090

クライアントは、インターフェース・コードを要求書きます

package main

import (
    "hello/go_client/proto/hello"
    "io"
    "log"
    "golang.org/x/net/context"
    "google.golang.org/grpc"
)

const (
    // gRPC 服务地址
    Address = "0.0.0.0:9090"
)

func main() {
    conn, err := grpc.Dial(Address, grpc.WithInsecure())
    if err != nil {
        log.Fatalln(err)
    }
    defer conn.Close()

    // 初始化客户端
    c := hello.NewHelloClient(conn)

    // 调用 SayHello 方法
    res, err := c.SayHello(context.Background(), &hello.HelloRequest{Name: "Hello World"})

    if err != nil {
        log.Fatalln(err)
    }

    log.Println(res.Message)

    // 调用 LotsOfReplies 方法
    stream, err := c.LotsOfReplies(context.Background(),&hello.HelloRequest{Name: "Hello World"})
    if err != nil {
        log.Fatalln(err)
    }

    for {
        res, err := stream.Recv()
        if err == io.EOF {
            break
        }

        if err != nil {
            log.Printf("stream.Recv: %v", err)
        }

        log.Printf("%s", res.Message)
    }
}

実行します。

go run main.go

2019/07/28 17:58:13 Hello World
2019/07/28 17:58:13 Hello World Reply 0
2019/07/28 17:58:13 Hello World Reply 1
2019/07/28 17:58:13 Hello World Reply 2
2019/07/28 17:58:13 Hello World Reply 3
2019/07/28 17:58:13 Hello World Reply 4
2019/07/28 17:58:13 Hello World Reply 5
2019/07/28 17:58:13 Hello World Reply 6
2019/07/28 17:58:13 Hello World Reply 7
2019/07/28 17:58:13 Hello World Reply 8
2019/07/28 17:58:13 Hello World Reply 9

ソースを表示：https://github.com/xinliangnote/Go

推奨読書

ジンフレームワーク

• ジンのフレームワーク - カスタムエラー処理
• ジンフレーム - バインディングと検証データ
• ジンフレーム - Logrusを使用してログインします
• ジンフレーム - ルーティングの設定とインストール

基本

• 行く - 機能
• 行く - サイクリング
• 行く - 地図コレクション
• 行く - 構造体の構造
• 行く - スライススライス
• 行く - アレイ
• 行く - 変数宣言を
• 行く - 環境インストール

この記事へようこそ転送は、ソースと作者を明記してください、ありがとうございました！