使用Rust构建gRPC服务器

Florian Krumm在Unsplash上拍摄的照片。

一旦我理解了gRPC和Thrift,就很难再回到使用更过渡性的基于JSON的REST API或SOAP API。

gRPC和Thrift这两个著名的RPC框架有很多相似之处。前者来自谷歌,后者来自脸书。它们易于使用,对许多编程语言都有很好的支持,并且性能很高。

最有价值的功能是多语言代码生成和服务器端反射。这些使得API本质上是类型安全的。使用服务器端反射,您可以更容易地探索API的模式定义,而无需阅读和理解实现。

阿帕奇节俭在历史上一直是一个受欢迎的选择。然而,近年来,由于缺乏脸书的持续支持以及与FB third的分歧,它逐渐失去了人气。

与此同时,gRPC赶上了越来越多的功能,拥有了更健康的生态系统。

GRPC(蓝色)和阿帕奇节俭(红色)之间的比较。谷歌趋势

GitHub在gRPC、fbThrift和Apache Thrift中的明星历史。

直到今天,没有好的理由考虑节俭,除非你的应用程序在某种程度上属于脸书。

GraphQL是脸书提出的另一个框架。它和上面两个RPC框架有很多相似之处。

移动API开发最大的一个痛点就是有些用户从来不升级自己的应用。因为我们希望保持向后兼容性,所以我们必须要么在API中保留旧的未使用的字段,要么创建API的多个版本。GraphQL的一个动机就是解决这个问题。它被设计成一种“查询语言”,允许客户指定它需要的数据字段。这使得处理向后兼容性更加容易。

GraphQL在开发移动API和面向公共的API(如GitHub)方面有很大的价值。因为,在这两种情况下,我们都无法轻易控制当事人的行为。

然而,如果我们正在为Web前端或内部后端服务构建API,那么选择GraphQL而不是gRPC几乎没有什么好处。

以上是目前为止网络框架的一个小概述。除了网络,我们还需要决定应用服务器的语言。

基于栈溢出调查:“Rust是过去六年最流行的语言。”虽然学习曲线相对陡峭,但其类型安全、优雅的内存管理、广泛的社区支持和性能都使Rust成为一种非常有吸引力和前景的后端服务开发编程语言。

Rust是Stackoverflow调查中最受欢迎的语言2021

我们也开始看到Rust在行业中越来越广泛的应用:脸书、Dropbox、Yelp、AWS、Google等等。显然,铁锈会继续生长和存在。

这就是我们将在今天的教程中看到的——在Rust中用gRPC构建一个小型服务器。

使用以下命令安装Rust:

如果您之前安装了Rust,我们可以通过以下方式进行更新:

让我们仔细检查一下rustc(Rust编译器)和cargo(Rust包管理器)的安装版本:

有关安装的更多信息,请参见https://www.rust-lang.org/tools/install.

运行以下命令创建一个新的“Hello World”项目:

让我们编译并运行程序:

这显示了我们到目前为止的文件结构:

GRPC使用协议缓冲区来序列化和反序列化数据。Proto让我们在一个文件中定义服务器API。

我们定义了一个书店服务,只有一种方法:提供一个图书id,并返回该书的一些详细信息。

我们将使用tonic来创建我们的gRPC服务。将以下依赖项添加到Cargo.toml文件中:

为了从生成Rust code bookstore.proto,我们在crate的build.rs构建脚本中使用tonic-build。

将以下内容添加到build.rs文件中:

需要特别指出的一点是,我们加的。out _ dir("。/src ")将默认的输出目录改为这个src目录,这样我们就可以更方便地查看生成的文件,达到本文的目的。

在我们准备编译之前还有一件事。Tonic-build依靠协议缓冲编译器来解析文件。原型转化为可以转化为铁锈的表示。让我们安装protobuf:

并仔细检查protobuf编译器是否安装正确:

准备编译:

这样,我们应该从src/bookstore.rs生成一个文件。此时,我们的文件结构应该如下所示:

最后,是时候把服务放在一起了。用main.rs替换,如下所示:

我们可以看到,为了简单起见,我们没有一个真正的图书设置数据库。在这个端点中,我们只是返回一本假书。

运行服务器的时间:

很好,我们在Rust中启动并运行了gRPC服务器!

就像我开头说的,gRPC一开始给我留下了很深的印象,因为它有做服务器反射的能力。不仅在服务开发过程中很方便,也让与前端工程师的沟通更容易。因此,如果没有解释如何将其添加到Rust服务器,教程是不完整的。

将以下内容添加到依赖关系中:

需要修改的Update build.rs行标有// Add this注释。

最后,更新到main.rs,如下所示。

可以使用gRPC服务器的GUI客户端有很多,比如Postman、Kreya、bloomrpc、grpcox等。为简单起见,我们将使用命令行工具grpc_cli。

安装:

并测试我们的第一个gRPC端点:

看起来很管用!我的朋友,这就是我们如何在Rust中构建gRPC服务器的。

这是今天的内容。感谢阅读和快乐编码!和往常一样,源代码可以在GitHub上获得。