在 gRPC 里客户端运用可以像调用本地工具一样直接调用另一台不同的机器上做事端运用的方法，使得我们能够更随意马虎地创建分布式运用和做事。
gRPC 客户端和做事端可以在多种环境中运行和交互，并且可以用任何 gRPC 支持的措辞来编写。
gRPC 支持 C++ Java Python Go Ruby C# Node.js PHP Dart 等措辞
gRPC 默认利用 protocol buffers，这是 Google 开源的一种轻便高效的构造化数据存储格式，可以用于构造化数据串行化，或者说序列化。它很适宜做数据存储或 RPC 数据交流格式。
安装 Google Protocol Buffer方法一（建议利用）
参考文档：gRPC Python Quickstart
1. 安装 gRPC
2. 安装 gRPC tools
Python gPRC tools 包含 protocol buffer 编译器和用于从 .proto 文件天生做事端和客户端代码的插件
方法二：
在 github 页面protobuf Buffers可以下载二进制源码，下载后实行以下命令安装：
由于是要利用 Protobuf + Python 测试，以是还要安装 python运行环境。protobuf Buffers python 文档
Protobuf 基本利用
定义一个类型
先来看一个非常大略的例子。假设你想定义一个“搜索要求”的格式，每一个要求含有一个查询字符串、你感兴趣的查询结果所在的页数，以及每一页多少条查询结果。可以采取如下的办法来定义类型的.proto文件了：
文章的第一行指定了你正在利用 proto3 语法：如果不指定，编译器会利用 proto2。这个指定语法必须是文件的非空非注释的第一行。SearchRequest格式有三个字段，在中承载的数据分别对应于每一个字段。个中每个字段都有一个名字和一种类型。向.proto文件添加注释，可以利用C/C++/java风格的双斜杠(//) 语法格式。在体中，每个字段都有唯一的一个数字标识符。这些标识符用来在的二进制格式中识别各个字段，一旦开始利用就不能再改变。
[1,15]之内的标识号在编码的时候会占用一个字节。[16,2047]之内的标识号则占用2个字节。以是该当为那些频繁涌现的元素保留 [1,15]之内的标识号。牢记：要为将来有可能添加的、频繁涌现的标识号预留一些标识号。
指定字段规则
所指定的字段润色符必须是如下之一：
singular：一个格式良好的该当有0个或者1个这种字段（但是不能超过1个）。repeated：在一个格式良好的中，这种字段可以重复任意多次（包括0次）。重复的值的顺序会被保留。在proto3中，repeated的标量域默认情形虾利用packed。message Test4 { repeated int32 d = 4 [packed=true];}数值类型
一个标量字段可以含有一个如下的类型——该表格展示了定义于.proto文件中的类型，以及与之对应的、在自动天生的访问类中定义的类型：
默认值
当一个被解析的时候，如果被编码的信息不包含一个特定的singular元素，被解析的工具锁对应的域被设置位一个默认值，对付不同类型指定如下：
对付strings，默认是一个空string对付bytes，默认是一个空的bytes对付bools，默认是false对付数值类型，默认是0对付列举，默认是第一个定义的列举值，必须为0;对付类型（message），域没有被设置，确切的是根据措辞确定的，详见generated code guide对付可重复域的默认值是空（常日情形下是对应措辞中空列表）。嵌套类型
你可以在其他类型中定义、利用类型，不才面的例子中，Result就定义在SearchResponse内，如：
在 message SearchResponse 中，定义了嵌套 Result，并用来定义SearchResponse中的results域。
Protobuf 文件编译从.proto文件天生了什么？
当用protocol buffer编译器来运行.proto文件时，编译器将天生所选择措辞的代码，这些代码可以操作在.proto文件中定义的类型，包括获取、设置字段值，将序列化到一个输出流中，以及从一个输入流中解析。
对C++来说，编译器会为每个.proto文件天生一个.h文件和一个.cc文件，.proto文件中的每一个有一个对应的类。对Java来说，编译器为每一个类型天生了一个.java文件，以及一个分外的Builder类（该类是用来创建类接口的）。对Python来说，有点不太一样——Python编译器为.proto文件中的每个类型天生一个含有静态描述符的模块，，该模块与一个元类（metaclass）在运行时（runtime）被用来创建所需的Python数据访问类。对go来说，编译器会位每个类型天生了一个.pd.go文件。对付Ruby来说，编译器会为每个类型天生了一个.rb文件。javaNano来说，编译器输出类似域java但是没有Builder类对付Objective-C来说，编译器会为每个类型天生了一个pbobjc.h文件和pbobjcm文件，.proto文件中的每一个有一个对应的类。对付C#来说，编译器会为每个类型天生了一个.cs文件，.proto文件中的每一个有一个对应的类。Python gRPC 示例编译
这里我们用Python 编译一下，看得到什么：
利用以下命令编译:
天生了两个文件：
hello_pb2.py 此文件包含天生的 request(HelloRequest) 和 response(HelloReply) 类。hello_pb2_grpc.py 此文件包含天生的 客户端(GreeterStub)和做事端(GreeterServicer)的类。源码地址为https://github.com/grpc/grpc/blob/master/examples/protos/helloworld.proto
虽然现在已经天生了做事端和客户端代码，但是我们还须要手动实现以及调用的方法。
创建做事端代码创建和运行 Greeter 做事可以分为两个部分：
实现我们做事定义的天生的做事接口：做我们的做事的实际的“事情”的函数。运行一个 gRPC 做事器，监听来自客户真个要求并传输做事的相应。在当前目录，打开文件 greeter_server.py，实现一个新的函数：
更新客户端代码
在当前目录，打开文件 greeter_client.py，实现一个新的函数：
对付返回单个应答的 RPC 方法（\"大众response-unary\"大众 方法），gRPC Python 同时支持同步（壅塞）和异步（非壅塞）的掌握流语义。对付应答流式 RPC 方法，调用会立即返回一个应答值的迭代器。调用迭代器的 next() 方法会壅塞，直到从迭代器产生的应答变得可用。
运行代码
首先运行做事端代码然后运行客户端代码源码地址: https://github.com/grpc/grpc/tree/master/examples/python
参考链接[1] gRPC 官方文档中文版: https://doc.oschina.net/grpc?t=56831
[2] Protobuf3措辞指南: https://blog.csdn.net/u011518120/article/details/54604615
[3] Google Protocol Buffer 的利用和事理: https://www.ibm.com/developerworks/cn/linux/l-cn-gpb/index.html
[4] gRPC Python Quickstart: https://grpc.io/docs/quickstart/python.html
#python# #Python# #grpc# #golang#
