下面是对gRPC和protocol buffers的介绍。
这个页面介绍gRPC和protocol buffers。gRPC可以使用protocol buffers作为它的接口定义语言(IDL)和它的底层消息交换格式。
综述
在gRPC中，客户端应用程序可以像调用本地对象一样直接调用另一台机器上的服务器应用程序上的方法，从而更容易创建分布式应用程序和服务。与许多RPC系统一样，gRPC基于定义服务的思想，指定可以通过其参数和返回类型远程调用的方法。在服务器端，服务器实现这个接口并运行gRPC服务器来处理客户端调用。在客户端，客户端有一个存根(在某些语言中称为客户端)，它提供和服务端相同的方法。
gRPC客户端和服务器可以在各种环境中运行并相互通信——从谷歌内部的服务器到你自己的桌面——并且可以用gRPC支持的任何语言编写。因此，例如，你可以轻松地用Java创建gRPC服务器，用Go、Python或Ruby创建客户端。此外，最新的谷歌api将有gRPC版本的接口，让你可以轻松地将谷歌功能构建到你的应用程序中。
使用Protocol Buffers
默认情况下，gRPC使用protocol buffers，这是谷歌成熟的开源机制，用于序列化结构化数据(尽管它也可以用于其他数据格式，如JSON)。下面是它如何工作的快速介绍。如果您已经熟悉了protocol buffers，请直接跳到下一节。
使用protocol buffers时，第一步是为要在proto文件中序列化的数据定义结构:这是一个扩展名为.proto的普通文本文件。protocol buffers数据结构为消息，其中每个消息都是包含一系列成对的name-value的信息。这里有一个简单的例子:
message Person {
string name = 1;
int32 id = 2;
bool has_ponycopter = 3;
}
然后，一旦指定了数据结构，就可以使用protocol buffers编译器协议从原型定义生成使用你偏好的语言的数据访问类。它们为每个字段提供了简单的访问器，如name()和set_name()，以及序列化/从原始字节解析整个结构的方法。因此，例如，如果您选择的语言是c++，在上面的示例上运行编译器将生成一个名为Person的类。然后，您可以在应用程序中使用这个类来填充、序列化和检索Person protocol buffers消息。
在普通的proto文件中定义gRPC服务，RPC方法参数和返回类型指定为protocol buffers消息:
// The greeter service definition.
service Greeter {
// Sends a greeting
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
// The request message containing the user's name.
message HelloRequest {
stringname = 1;
}
// The response message containing the greetings
message HelloReply {
stringmessage = 1;
}
gRPC使用protoc和一个特殊的gRPC插件从你的proto文件中生成代码:你得到生成的gRPC客户端和服务器代码，以及用于填充、序列化和检索消息类型的常规protocol buffer代码。您将在下面看到这样的示例。
要了解更多关于protocol buffers的信息，包括如何在您选择的语言中安装带有gRPC插件的协议，请参阅protocol buffers文档。
Protocol buffer版本
虽然开源用户已经可以使用protocol buffers一段时间了，但这个网站上的大多数例子都使用protocol buffers版本3 (proto3)，它有略微简化的语法，一些有用的新特性，并支持更多的语言。Proto3目前有Java, c++， Dart, Python, Objective-C, c#， lite运行时(Android Java)， Ruby, JavaScript，以及golang/protobuf GitHub repo的Go语言生成器，还有更多正在开发的语言。你可以在proto3语言指南和每种语言的参考文档中找到更多信息。参考文档还包括.proto文件格式的正式规范。
一般来说，虽然你可以使用proto2(当前默认的protocol buffers版本)，但我们建议你使用proto3和gRPC一起使用，因为它可以让你使用gRPC支持的所有语言，同时避免与proto2客户端和proto3服务器通信的兼容性问题，反之亦然。
