让我们尝试使用适合初学者的Golang gRPC

2 年 ago
科, 颖
5 minutes

首先

「gRPC是什么？」
「听说过gRPC，但从未使用过。」
「要在Golang/Go语言中使用gRPC，怎样做才好？」

我写下了适合这样的人（包括我自己）。
让我们在Golang中尝试使用gRPC。

我参考了「Go快速入门」。
https://grpc.io/docs/quickstart/go.html

gRPC是什么

gRPC 是由 Google 开发的一种协议。它默认使用Protocol Buffer来对数据进行串行化，从而实现快速通信的能力。

在gRPC中，客户端应用程序可以像调用本地对象一样直接调用位于不同机器上的服务器应用程序的方法，因此可以轻松创建分布式应用程序和服务。

gRPC支持多种语言。例如，使用Go、Python或Ruby的客户端，可以轻松创建Java的gRPC服务器。

image.png

试着用Golang进行开发

Go的版本是多少？

gRPC 可以在 Go 的版本 1.6 或以上中使用。请使用以下命令确认版本。

$ go version

安装gRPC。

通过以下命令安装gRPC。

$ go get -u -v google.golang.org/grpc

安装Protocol Buffers v3

根据自己的环境，从这里进行下载：
https://github.com/protocolbuffers/protobuf/releases

请将已解压的目录中的/bin文件夹中的可执行文件移动到经过PATH设置的目录中。

此外，Mac情况下也可以使用下面的命令进行安装。

$ brew install protobuf

接下来，我们将按照以下方式安装用于Golang的protoc插件。

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

如果您尚未通過Golang的Path，請按照下述方式設定Path。

$ export PATH=$PATH:$GOPATH/bin

建造样本

我要切换到样本目录。

$ cd $GOPATH/src/google.golang.org/grpc/examples/helloworld

在gRPC中，我们创建.proto文件。
使用protoc编译器来构建.proto文件，并生成.pb.go文件。
(※在示例中已经创建了helloworld.pb.go文件。)

$ protoc -I helloworld/ helloworld/helloworld.proto --go_out=plugins=grpc:helloworld

你好世界的执行

执行服务器和客户端，尝试运行HelloWorld。

$ go run greeter_server/main.go

打开另一个终端并执行以下操作。

$ go run greeter_client/main.go

使用gRPC，我们能够成功运行客户端-服务器应用程序，结果显示”打招呼：Hello world”。

gRPC的更新

我尝试更新 gRPC。我将 helloworld.proc 更新如下所示：添加了 SayHelloAgain。

// Copyright 2015 gRPC authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

syntax = "proto3";

option java_multiple_files = true;
option java_package = "io.grpc.examples.helloworld";
option java_outer_classname = "HelloWorldProto";

package helloworld;

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
  // Sends another greeting
  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;
}

使用protoc编译器，构建.proto文件，并生成.pb.go文件。

$ protoc -I helloworld/ helloworld/helloworld.proto --go_out=plugins=grpc:helloworld

接下来，我们将更新greeter_server/main.go文件。

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

添加后，如下所示。

/*
 *
 * Copyright 2015 gRPC authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

//go:generate protoc -I ../helloworld --go_out=plugins=grpc:../helloworld ../helloworld/helloworld.proto

// Package main implements a server for Greeter service.
package main

import (
    "context"
    "log"
    "net"

    "google.golang.org/grpc"
    pb "google.golang.org/grpc/examples/helloworld/helloworld"
)

const (
    port = ":50051"
)

// server is used to implement helloworld.GreeterServer.
type server struct{}

// SayHello implements helloworld.GreeterServer
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
    log.Printf("Received: %v", in.Name)
    return &pb.HelloReply{Message: "Hello " + in.Name}, nil
}

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{})
    if err := s.Serve(lis); err != nil {
        log.Fatalf("failed to serve: %v", err)
    }
}

接下来，我们将更新greeter_client/main.go文件。

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

添加上述内容后，会变成如下：

/*
 *
 * Copyright 2015 gRPC authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

// Package main implements a client for Greeter service.
package main

import (
    "context"
    "log"
    "os"
    "time"

    "google.golang.org/grpc"
    pb "google.golang.org/grpc/examples/helloworld/helloworld"
)

const (
    address     = "localhost:50051"
    defaultName = "world"
)

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]
    }
    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.Message)
    r, err = c.SayHelloAgain(ctx, &pb.HelloRequest{Name: name})
    if err != nil {
            log.Fatalf("could not greet: %v", err)
    }
    log.Printf("Greeting: %s", r.Message)
}

让我们像上面那样运行服务器和客户端，并执行 HelloWorld。

$ go run greeter_server/main.go

打开另一个终端，并执行以下操作。

$ go run greeter_client/main.go

然后，会显示以下内容：
打招呼：你好，世界
再次打招呼：你好，再次世界

我可以使用gRPC更新客户端-服务器应用程序。

结束

我使用Golang尝试了一下gRPC的运行。

使用gRPC时，将无法使用Rest API，但使用gRPC-gateway可以解决这个问题。有关此内容将另行说明。

我已经记录下来了。

✖
广告
将在 10 秒后关闭
bannerAds