本文是 https://grpc.io/docs/what-is-grpc/introduction/ 的摘译

一个 gRPC 和 protocol buffers 的入门指南

概述

gPRC功能是让你能像调用本地方法一样，调用定义在服务器上的方法。这对分布式服务很有用。

gRPC 的客户端和服务端可在任何环境下运行，例如 Google 网站和你自己的笔记本电脑。他们可以用任何 gRPC 支持的语言实现（gRPC 支持 Java, Python, GO 等语言）。而且客户端的语言可以和服务端不一致，比如客户端可以用 Java 写，服务端则可以用 GO 写。

而且 Google 自身有很多对外的 API 开放，这些 API 有 gRPC 版本，你可以很容易集成到你自己的程序中。

Protocol Buffers

gPRC默认使用 Protocol Buffers, 这是 Google 的开源的成熟的序列化结构数据的机制（类似JSON）。

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

上面是一个普通的 .proto 文件。Protocol buffer 数据用 messages 的形式组织。每个 message 都是一个小的逻辑记录，包含了一系列的键值组合（这里称之为"fields"（字段））。

然后，一旦定义了数据结构，你可以用 protoc 编译器生成 proto 定义的调用类。比如 name(), set_name()，还有一些对 proto 结构进行序列化或 parse 以与原始字节进行转换。例如，如果你用 C++，把上面 Proto 文件编译成一个 Person 类。然后你可以用这个类来填充、序列化、获取 protocol buffer 的 Person 消息。

gRPC 服务是定义在普通的 proto 文件中，包含 RPC 方法参数和返回值。

// 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 使用 protoc 作为 gRPC 插件，来从 proto 文件生成一些代码。这些生成代码你是可以看到的，就像正常的 protocol buffer 代码一样。