gRPC 简介

本页向您介绍 gRPC 和 Protocol Buffers。gRPC 可以使用 Protocol Buffers 作为其接口定义语言（IDL）和底层消息交换格式。如果您是 gRPC 和/或 Protocol Buffers 的新手，请阅读本文！如果您只想先亲自动手看看 gRPC 的实际应用，请选择一种语言并尝试其快速入门。

概述

在 gRPC 中，客户端应用程序可以直接调用另一台机器上的服务器应用程序上的方法，就像调用本地对象一样，这使得创建分布式应用程序和服务变得更加容易。与许多 RPC 系统一样，gRPC 基于定义服务、指定可远程调用的方法及其参数和返回类型的理念。在服务器端，服务器实现此接口并运行 gRPC 服务器来处理客户端调用。在客户端，客户端有一个存根（在某些语言中简称为客户端），它提供与服务器相同的方法。

gRPC 客户端和服务器可以在各种环境中运行并相互通信——从 Google 内部的服务器到您自己的桌面——并且可以使用 gRPC 支持的任何语言编写。例如，您可以轻松地用 Java 创建一个 gRPC 服务器，并用 Go、Python 或 Ruby 编写客户端。此外，最新的 Google API 将提供其接口的 gRPC 版本，让您能够轻松地将 Google 功能构建到您的应用程序中。

使用 Protocol Buffers

默认情况下，gRPC 使用 Protocol Buffers，这是 Google 成熟的开源结构化数据序列化机制（尽管它也可以与其他数据格式（如 JSON）一起使用）。以下是其工作原理的快速介绍。如果您已经熟悉 Protocol Buffers，请随意跳到下一节。

使用 Protocol Buffers 的第一步是在proto 文件中定义要序列化的数据结构：这是一个带有 .proto 扩展名的普通文本文件。Protocol Buffer 数据以消息的形式结构化，其中每个消息都是一个包含一系列名称-值对（称为字段）的小型逻辑信息记录。这是一个简单的示例

message Person {
  string name = 1;
  int32 id = 2;
  bool has_ponycopter = 3;
}

然后，一旦您指定了数据结构，就可以使用 Protocol Buffer 编译器 protoc 从您的 proto 定义中生成您偏好语言的数据访问类。这些类为每个字段提供简单的访问器，例如 name() 和 set_name()，以及将整个结构序列化/解析为/从原始字节的方法。因此，例如，如果您选择的语言是 C++，在上述示例上运行编译器将生成一个名为 Person 的类。然后，您可以在应用程序中使用此类的实例来填充、序列化和检索 Person Protocol Buffer 消息。

您在普通的 proto 文件中定义 gRPC 服务，其中 RPC 方法参数和返回类型被指定为 Protocol Buffer 消息

// The greeter 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;
}

gRPC 使用带有特殊 gRPC 插件的 protoc 从您的 proto 文件生成代码：您将获得生成的 gRPC 客户端和服务器代码，以及用于填充、序列化和检索消息类型的常规 Protocol Buffer 代码。要了解更多关于 Protocol Buffers 的信息，包括如何在您选择的语言中安装带有 gRPC 插件的 protoc，请参阅 Protocol Buffers 文档。

Protocol Buffer 版本

尽管 Protocol Buffers 已向开源用户提供了一段时间，但本站的大多数示例都使用 Protocol Buffers 版本 3 (proto3)，它具有稍微简化的语法、一些有用的新功能，并支持更多语言。Proto3 目前可通过 Protocol Buffers GitHub 仓库 在 Java、C++、Dart、Python、Objective-C、C#、lite-runtime (Android Java)、Ruby 和 JavaScript 中使用，以及通过 golang/protobuf 官方包 提供 Go 语言生成器，更多语言正在开发中。您可以在 proto3 语言指南 和每种语言的参考文档中找到更多信息。参考文档还包括 .proto 文件格式的正式规范。

通常，虽然您可以使用 proto2（当前默认的 Protocol Buffers 版本），但我们建议您将 proto3 与 gRPC 结合使用，因为它允许您使用 gRPC 支持的全部语言，并避免 proto2 客户端与 proto3 服务器通信时的兼容性问题，反之亦然。