GoLang：gRPC协议的介绍以及详细教程，从Protocol开始

目录

​编辑

引言

一、安装相关Go语言库和相关工具

1. 安装Go

2. 安装Protocol Buffers Compiler

2.1 Windows

2.1.1 下载

2.1.2 解压

2.1.3 环境变量

2. macOS

3. Linux

4. 验证安装

3. 安装gRPC-Go

4. 安装Protocol Buffers的Go插件

二、定义服务

三、生成Go语言代码

四、实现服务端

1. 实现Proto定义的服务接口。

2. 启动gRPC服务器监听端口，注册服务。

五、实现客户端

1. 连接到gRPC服务器。

2. 调用服务方法。

六、测试

---

引言

gRPC（Google Remote Procedure Call）是一个由Google开发的高性能、开源RPC（远程过程调用）框架。它基于HTTP/2进行数据传输，使用ProtoBuf（Protocol Buffers）作为接口描述语言，支持多种编程语言，如Java、Go、C#等，适用于不同语言环境。gRPC的显著特点包括其高效的通信性能，支持双向流、多路复用和二进制传输，以及集成的安全机制，如SSL/TLS。这些特性使gRPC特别适合用于构建高性能的分布式系统和微服务架构中的服务间通信，尤其在需要处理大量数据和高吞吐量的场景中表现出色。

一、安装相关Go语言库和相关工具

1. 安装Go

确保安装了最新版本的Go。All releases - The Go Programming Language

2. 安装Protocol Buffers Compiler

2.1 Windows

2.1.1 下载

https://github.com/protocolbuffers/protobuf/releases/download/v25.1/protobuf-25.1.zip

下载适用于Windows的protoc-<version>.zip文件。

如果上面链接失效请访问官网地址：https://github.com/protocolbuffers/protobuf/releases

2.1.2 解压

解压下载的文件到一个你选择的目录。

2.1.3 环境变量

将解压后的bin目录添加到你的环境变量PATH中。这样可以从任意位置运行protoc。

• 右击“我的电脑”或“此电脑”，选择“属性”。
• 点击“高级系统设置”，然后点击“环境变量”。
• 在“系统变量”下，找到并选择PATH，点击“编辑”。
• 添加解压后的bin目录的路径，点击“确定”。

2. macOS

在 macOS 上，你可以使用 Homebrew 来安装 protoc：

brew install protobuf

3. Linux

ProtoBuf编译器用于编译.proto文件。

对于大多数基于Debian的Linux发行版（如Ubuntu），你可以使用以下命令安装：

sudo apt-get install protobuf-compiler

 对于基于RPM的发行版（如Fedora、CentOS），你可以使用：

sudo dnf install protobuf-compiler

4. 验证安装

安装完成后，你可以在命令行中运行以下命令来验证安装：

protoc --version

3. 安装gRPC-Go

通过go get安装gRPC的Go实现的包。

go get -u google.golang.org/grpc

4. 安装Protocol Buffers的Go插件

go get -u google.golang.org/protobuf/cmd/protoc-gen-go \
         google.golang.org/grpc/cmd/protoc-gen-go-grpc

二、定义服务

创建Proto文件：定义服务接口和消息格式。例如，创建helloworld.proto。

syntax = "proto3";

package helloworld;

service Greeter {
    rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
    string name = 1;
}

message HelloReply {
    string message = 1;
}

三、生成Go语言代码

使用ProtoBuf编译器生成Go代码。

protoc --go_out=. --go_opt=paths=source_relative \
       --go-grpc_out=. --go-grpc_opt=paths=source_relative \
       helloworld/helloworld.proto

四、实现服务端

1. 实现Proto定义的服务接口。

2. 启动gRPC服务器监听端口，注册服务。

package main

import (
    "context"
    "log"
    "net"
    "google.golang.org/grpc"
    pb "path/to/your/service"
)

type server struct {
    pb.UnimplementedGreeterServer
}

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

func main() {
    lis, err := net.Listen("tcp", ":50051")
    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)
    }
}

五、实现客户端

1. 连接到gRPC服务器。

2. 调用服务方法。

package main

import (
    "context"
    "log"
    "time"
    "google.golang.org/grpc"
    pb "path/to/your/service"
)

func main() {
    conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure(), grpc.WithBlock())
    if err != nil {
        log.Fatalf("did not connect: %v", err)
    }
    defer conn.Close()
    c := pb.NewGreeterClient(conn)

    name := "world"
    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.GetMessage())
}

六、测试

运行服务器和客户端，确保它们能够相互通信。