gRPC入门教程：从零开始构建RPC服务-优快云博客

本文链接：https://blog.youkuaiyun.com/l19960203/article/details/118543397

1. 基本概念

RPC（Remote Procedure Call）远程过程调用，简单的理解是一个节点请求另一个节点提供的服务
本地过程调用：如果需要将本地student对象的age+1，可以实现一个addAge()方法，将student对象传入，对年龄进行更新之后返回即可，本地方法调用的函数体通过函数指针来指定。
远程过程调用：上述操作的过程中，如果addAge()这个方法在服务端，执行函数的函数体在远程机器上，如何告诉机器需要调用这个方法呢？
1. 首先客户端需要告诉服务器，需要调用的函数，这里函数和进程ID存在一个映射，客户端远程调用时，需要查一下函数，找到对应的ID，然后执行函数的代码。
2. 客户端需要把本地参数传给远程函数，本地调用的过程中，直接压栈即可，但是在远程调用过程中不再同一个内存里，无法直接传递函数的参数，因此需要客户端把参数转换成字节流，传给服务端，然后服务端将字节流转换成自身能读取的格式，是一个序列化和反序列化的过程。
3. 数据准备好了之后，如何进行传输？网络传输层需要把调用的ID和序列化后的参数传给服务端，然后把计算好的结果序列化传给客户端，因此TCP层即可完成上述过程，gRPC中采用的是HTTP2协议。

2. 准备工作

2.1 介绍

要完成一个RPC首先需要实现一个服务端节点，由客户端去连接节点，再进行调用节点中的方法。
这里介绍使用gRPC，借助gRPC，我们可以在.proto文件中定义我们的服务，并以gRPC支持的任何语言来实现客户端和服务器，客户端和服务器又可以在从服务器到你自己的平板电脑的各种环境中运行-gRPC还会为你解决所有不同语言和环境之间通信的复杂性。我们还获得了使用protocol buffer的所有优点，包括有效的序列化（速度和体积两方面都比JSON更有效率），简单的IDL（接口定义语言）和轻松的接口更新。

2.2 安装

首先需要安装gRPC golang版本的软件包，同时官方软件包的examples目录里就包含了教程中示例路线图应用的代码
执行 go get google.golang.org/grpc 将所需的包拉下来

2.3 安装相关工具和插件

安装protocol buffer编译器，安装编译器最简单的方式是去https://github.com/protocolbuffers/protobuf/releases 下载预编译好的protoc二进制文件，仓库中可以找到每个平台对应的编译器二进制文件。这里我们以Mac Os为例，从https://github.91chifun.workers.dev/https://github.com//protocolbuffers/protobuf/releases/download/v3.17.3/protoc-3.17.3-osx-x86_64.zip 下载并解压文件，更新PATH系统变量，或者确保protoc放在了PATH包含的目录中了。
安装protoc编译器插件，执行go get -u github.com/golang/protobuf/protoc-gen-go
编译器插件protoc-gen-go将安装在$GOBIN中，默认位于$GOPATH/bin。编译器protoc必须在$PATH中能找到它：
执行export PATH=$PATH:$GOPATH/bin

3. 定义服务

首先第一步是用protocol buffer定义gRPC服务还有方法的请求和响应类型，首先要创建一个后缀为.proto 的protoobuf文件
要定义服务，你需要在.proto文件中定义一个service

syntax = "proto3";

package UserRpc;

// 用户服务
service UserService{
	...
}

然后在服务中定义rpc方法，指定rpc方法的请求以及响应类型。
定义一个简单的获取用户详情rpc，客户端使用用户ID将请求发送到服务器，然后等待响应返回，就像普通的函数调用一样。
rpc GetUserDetail(GetUserDetailReq) returns (GetUserDetailRes) {}
对应的请求以及响应类型需要通过message来声明具体的类

// 获取用户详情请求
message GetUserDetailReq {
    int64 id = 1;
}
// 获取用户详情响应
message GetUserDetailRes {
    int64  id       = 1;
    string username = 2;
}

执行protoc --go_out=. user.proto 来生成go的pb文件
执行后目录下就会生成user.pb.go文件，里面就有我们定义的rpc接口了，那么接下来创建server,client两个文件夹，分别是服务端和客户端
首先来实现一个服务端，将rpc接口代码实现
首先我们会需要用到grpc包，那么是要将这个包拉下来，加入到go.mod
分别执行go get -u google.golang.org/grpc go get -u google.golang.org/grpc/reflection
这样就可以继续我们的下一步了
鼠标选中定义的结构体然后按住option+回车（windows是alt+回车)，选中Implement interface 在弹出的窗口输入user就会出现UserServiceServer这个就是服务端代码的实现了
回车选中后会自动将rpc接口的服务端方法实现，接下来在里面写服务端处理的逻辑
实现了服务端的一个获取用户详情Rpc接口，那么客户端要请求到这个接口。哪就需要创建一个服务器来监听某个端口的请求，将Rpc服务注册，再映射到服务中去，这样一个服务端的Rpc就完成了，接下来打开终端进入到server目录中启动
这样服务端就已经完成了，那么接下来实现客户端，让客户端来连接服务端，请求接口拿到返回的数据
创建客户端，首先一样的在client文件夹中创建client.go文件
然后在文件中连接到服务端节点以及监听的端口，再初始化UserService服务的连接，然后通过连接去调用该服务下面的获取详情接口，接口会返回两个参数，对应的服务端的返回，一个Res，一个error
接下来再打开一个终端来运行一下client.go去连接到服务端获取用户详情的信息
到这里一个简单的Rpc服务端和客户端就完成了。

4. 结尾

我们的示例是一个简单的获取用户详情的应用，客户端可以传入用户ID获取用户的详细信息。
借助gRPC，我们可以在.proto文件中定义我们的服务，并以gRPC支持的任何语言来实现客户端和服务器，客户端和服务器又可以在从服务器到你自己的平板电脑的各种环境中运行-gRPC还会为你解决所有不同语言和环境之间通信的复杂性。我们还获得了使用protocol buffer的所有优点，包括有效的序列化（速度和体积两方面都比JSON更有效率），简单的IDL（接口定义语言）和轻松的接口更新。
该示例代码仓库：创建一个rpc服务