grpc-go 的安装和使用

介绍

Google 原生的 grpc 框架 是用 C 语言实现的,其默认包含了多种语言(cpp, ruby, python, c# 等)的实现,因而可以支持多种语言的 grpc 调用。但是默认没有提供 Go 和 Java 两种语言的 GRPC 实现。虽然如此,Google 官方在另外的单独的仓库中提供了 Go 语言版本的 GRPC 实现,也即 grpc-go(注:java 版的在 grpc-java 中),它们都在独立的 Repository 中。

这篇文章就来介绍下如何安装和使用 grpc-go,并构建基于 grpc-go 的程序。

grpc-go 安装

官方 repo 地址:https://github.com/grpc/grpc-go

(1) 依赖
需要至少 go 1.7+,以及 gRPC

(2)安装

go get -u google.golang.org/grpc

需要注意的是:这里安装的 grpc-go 只是一个第三方库,提供的是库函数接口,而不是二进制程序。因此,grpc-go 安装之后提供的是第三方包的作用。

在用户程序中,通常是通过下列方式来使用 grpc 包

(1)编写 .proto 文件

helloworld.proto

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) {}
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

(2)编译 .proto 文件

protoc --go_out=plugin=grpc:. *.proto

或者

protoc --gofast_out=plugins=grpc:. *.proto

(3)编写 client 端代码

package main

import (
    "log"
    "os"

    "golang.org/x/net/context"
    "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]
    }
    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)
}

注:以上内容来自 grpc-go 源码目录中的 examples/helloworld/greeter_client/main.go

(4)编写 server 端代码

package main

import (
    "log"
    "net"

    "golang.org/x/net/context"
    "google.golang.org/grpc"
    pb "google.golang.org/grpc/examples/helloworld/helloworld"
    "google.golang.org/grpc/reflection"
)

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) {
    return &pb.HelloReply{Message: "Hello " + 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)
    }
}

注:以上内容来自 grpc-go 源码目录中的 examples/helloworld/greeter_server/main.go

全文完

你可能感兴趣的:(grpc-go 的安装和使用)