本文翻译自gRPC简介
gRPC简介
gRPC和protocol buffers简介。
该页面向您介绍gRPC和protocol buffers。 gRPC可以将protocol buffers用作其接口定义语言(IDL)和其基础消息交换格式。 如果您不熟悉gRPC和/或protocol buffers,请阅读此内容! 如果您只是想深入了解gRPC的实际效果,请选择一种语言并尝试使用其快速入门
。
总览
在gRPC中,客户端应用程序可以直接在其他计算机上的服务器应用程序上调用方法,就好像它是本地对象一样,这使您更轻松地创建分布式应用程序和服务。 与许多RPC系统一样,gRPC围绕定义服务的思想,可通过其参数和返回类型指定远程调用的方法。 在服务器端,服务器实现此接口并运行gRPC服务器以处理客户端调用。 在客户端,客户端具有一个存根(在某些语言中仅称为客户端),提供与服务器相同的方法。
grpc服务端和客户端使用Protocol Buffers
默认情况下,gRPC使用Protocol Buffers(Google的成熟的开源机制)来序列化结构化数据(尽管它可以与其他数据格式(例如JSON)一起使用)。 这里是它的工作原理的快速介绍。 如果您已经熟悉Protocol Buffers,请随时跳到下一部分。
使用protocol buffers的第一步是为要在原始文件中序列化的数据定义结构:这是扩展名为.proto
的普通文本文件。Protocol buffer数据被构造为消息,其中每个消息都是信息的小逻辑记录,其中包含一系列称为字段的名称/值对。 这是一个简单的示例:
message Person {
string name = 1;
int32 id = 2;
bool has_ponycopter = 3;
}
然后,一旦指定了数据结构,就可以使用protocol buffer编译器protoc
从协议定义中以首选语言生成数据访问类。 这些为每个字段提供了简单的访问器,例如name()
和set_name()
,以及将整个结构序列化为原始字节或从原始字节中解析出整个结构的方法。 因此,例如,如果您选择的语言是C ++,则在上面的示例中运行编译器将生成一个名为Person
的类。 然后,您可以在应用程序中使用此类来填充,序列化和检索Person
protocol buffer消息。
您可以在普通的原始文件中定义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将protoc
与特殊的gRPC插件一起使用,以从proto文件生成代码:您将生成生成的gRPC客户端和服务器代码,以及用于填充,序列化和检索消息类型的常规protocol buffer代码。 您将在下面看到一个示例。
要了解有关协议缓冲区的更多信息,包括如何使用所选语言通过gRPC插件安装protoc
,请参阅protocol buffers文档。
Protocol buffer版本
虽然protocol buffers已可供开放源代码用户使用一段时间,但该站点上的大多数示例都使用protocol buffers版本3(proto3),该protocol buffers的语法略有简化,提供了一些有用的新功能,并且支持更多语言。 Proto3目前可用于Java,C ++,Dart,Python,Objective-C,C#,精简版运行时(Android Java),Ruby和JavaScript,它们来自protocol buffers GitHub repo,以及来自golang/protobuf GitHub repo。 ,更多语言正在开发中。您可以在proto3语言指南和每种语言的参考文档中找到更多信息。参考文档还包括.proto
文件格式的正式规范。
通常,虽然您可以使用proto2(当前的默认protocol buffers版本),但我们建议您将proto3与gRPC一起使用,因为它可以使用gRPC支持的所有语言,并且可以避免proto3服务器与proto2客户端通信时的兼容性问题,反之亦然。
支持的语言
每种gRPC语言/平台都有指向以下页面和更多页面的链接:
- 快速开始
- 讲解
- API参考
选择一种语言开始:
网友评论