1、安装

    go 语言版本的 grpc 安装需要 1.6 以上的 go 版本，所以你需要先执行 go version 查看 go 版本，假如版本低于 1.6 则需要先升级。

    官网上给的安装方式是

    因为 google.golang.org 这个域名在国内会被墙，所以假如可以翻墙的计算机可以用这种方式，不能翻墙的可以通过以下方式安装

    2. git clone https://github.com/golang/net.git  $GOPATH/src/golang.org/x/net
    3. git clone https://github.com/golang/text.git $GOPATH/src/golang.org/x/text 
    4. go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
    5. git clone https://github.com/google/go-genproto.git $GOPATH/src/google.golang.org/genproto
    7.  cd $GOPATH/src/
    8.  go install google.golang.org/grpc

    假如安装不成功则说明你 GOPATH 没有配置，可以先配置 GOPATH 后再执行

    1. // 配置 GOPATH
    2. export GOPATH=/Users/delvin/go

    2、hello world

    grpc-go 官方提供了一些 examples ，都放在 examples 目录下，examples 目录下有三个目录，features 目录主要是 grpc 的一些特写使用，包括路由寻址、keep-alive、负载均衡等。helloworld 目录下主要是提供了一个 helloworld demo。route_guide 目录主要提供了对 grpc 四种调用方式：Simple RPC、Client-side streaming RPC、Server-side streaming RPC、Bidirectional streaming RPC 的模拟调用 demo。

    我们通过 grpc 提供的 helloworld demo 来简单了解下如何使用 grpc 。

    之前我们说到了 grpc 是通过 protocol buffer 来实现接口的定义的。helloworld 包下已经给我们定义好了一个 helloworld.proto 如下：

    1. syntax = "proto3";
    3. option java_multiple_files = true;
    4. option java_package = "io.grpc.examples.helloworld";
    5. option java_outer_classname = "HelloWorldProto";
    7. package helloworld;
    9. service Greeter {
    10.   // Sends a greeting
    12. }
    14. // The request message containing the user's name.
    15. message HelloRequest {
    16.   string name = 1;
    17. }
    19. // The response message containing the greetings
    20. message HelloReply {
    21.   string message = 1;
    22. }
    1.  rpc SayHello (HelloRequest) returns (HelloReply) {}

    在 Service 中包含一个方法，SayHello, 支持传入一个 HelloRequest 的参数，返回一个 HelloReply 的响应。这两个结构体分别也在 proto 文件里面定义了。

    通过 protoc 可以生成一个 pb.go 文件（这里 demo ）里面已经生成好了。然后编写一个 client 和 server 即可实现一个完整的 rpc 调用链路，这里 demo 里面也提供了，我们先直接运行一下：

    先在一个 terminal 下执行：

    1. go run greeter_server/main.go

    然后在另一个 terminal 下执行：

    1. go run greeter_client/main.go

    此时 client 会输出 Greeting: Helloworld

    1. 2019/08/03 15:57:46 Greeting: Helloworld

    3、自定义一个 service

    这里也是 grpc docs 上一个相同的例子，我贴上来介绍一下，为了让本节内容更完整。

    （1）在 pb 文件里面添加一个 rpc 方法

    1.     // The greeting service definition.
    2.     service Greeter {
    3.       // Sends a greeting
    4.       // Sends another greeting
    6.     }
    8.     // The request message containing the user's name.
    9.     message HelloRequest {
    10.       string name = 1;
    11.     }
    13.     // The response message containing the greetings
    14.     message HelloReply {
    15.       string message = 1;
    16.     }

    （3）在 greeter_server/main.go 下添加一个方法，入参和返回值和 SayHello 完全相同，使用已经定义过的结构体 HelloRequest 和 HelloReply

    1. func (s *server) SayHelloAgain(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
    2.         return &pb.HelloReply{Message: "Hello again " + in.Name}, nil
    3. }

    （4）在 greeter_client/main.go 下添加一个方法调用，调用 SayHelloAgain 这个方法

    1. r, err = c.SayHelloAgain(ctx, &pb.HelloRequest{Name: name})
    2. if err != nil {
    3.         log.Fatalf("could not greet: %v", err)
    4. }
    5. log.Printf("Greeting: %s", r.Message)

    （5）执行

    先在一个 terminal 下执行：

      然后在另一个 terminal 下执行：

      可以看到 client 的 terminal 输出如下：

      这篇内容主要介绍了 grpc 的安装以及基本使用。分析了通过 grpc 输出 hello world 的基本要素和过程。