@levinzhang
2020-01-27T18:06:02.000000Z
字数 5751
阅读 597
在迁移至GraphQL解决方案的时候,我们经常会面临如何处理已有REST资产的问题,本文借助Space Cloud给出了无需修改任何代码就能以GraphQL方式访问REST服务的方案。
本文最初发表于DZone博客站点,经原作者Noorain Panjwani授权由InfoQ中文站翻译分享。
随着GraphQL在API领域的飞速发展,你可能想要知道如何在不破坏任何东西的情况下将现有的REST API迁移到GraphQL。本指南将会帮助你在不修改任何代码的情况下,完成REST到GraphQL迁移的任务,这样GraphQL就能让你的REST真正休息一下了。
GraphQL的支持者在宣传推广GraphQL方面已经做得非常好了。出于对他们努力的尊重,我不再深入介绍细节,而只是稍微总结一下:
在本指南中,我所介绍的将是大多数倡导GraphQL的人所忽略的一个方面,那就是“我们已经在REST方面有了巨大的投入”。这意味着:
虽然有许多文章帮助我们从REST迁移到GraphQL,但这些做法都迫使我们更改现有的代码库或在REST服务前面编写新的代码库。
注意:你可能还会喜欢该文:为什么以及何时使用GraphQL
如果它还能运行,那么就别去触碰它。
难道这不是编程的第一规则吗?
迁移可能是非常痛苦的,面对巨大的代码库时更会令人望而生畏。随时存在将已有的功能破坏掉的可能性。
面对现实吧,我们天生都是懒惰的。我们都喜欢简单的技巧和容易的解决方案。
如果能有那么一种方式,让我们原样保持REST服务,并且无需任何代码变更就能在它之上实现一个GraphQL层,那么将会怎样呢?听起来很神奇,对吧?Space Cloud就能够帮助我们让这一切变成现实。
简而言之,Space Cloud是一个开源的Web服务器,它能够在数据库和微服务之上即时提供GraphQL和REST API。
Space Cloud最酷的一点在于,所有的API都是实时的。我们可以选择订阅数据库的变更。在实现实时应用时,该功能是非常便利的。
但是,在本指南中,我们会使用Space Cloud的remote service
模块将REST服务迁移成GraphQL。
基于REST之上的GraphQL架构最终如下图所示:
我们的应用将会发起对Space Cloud的GraphQL查询,该请求又会访问服务器上的REST端点。在该场景中,Space Cloud会作为GraphQL代理或API网关。
你可能已经注意到,Space Cloud是一个单独的GraphQL层,位于REST服务之上。这种方式的优点在于REST服务依然能够保持原样,已有的客户端可以直接使用它们。这样,从REST服务迁移至GraphQL不会破坏旧的客户端。
非常棒!我们已经理解了什么是Space Cloud以及它如何与我们的应用共处。接下来,让我们开始行动吧!
在本指南中,我们将会构建一个简单的算数服务,它包含如下的端点:
POST
/adder
GET
/doubler/:num
求和计算端点将会返回两个数的和,这两个数是通过请求的body
获取到的。翻倍计算端点将会对其接收到的值翻倍,初始值是通过URL路径参数获取到的。
非常好!现在,我们开始构建吧。
现在,我们开始编写REST服务。在这里,我们使用NodeJS和Express来编写REST服务。
注意:你可以使用任意语言和框架来编写服务,只要它支持HTTP即可,因为这是Space Cloud用来与你的REST服务进行通信的协议。
首先,创建一个文件夹作为工作目录。
npm init -y
npm install --save express
创建名为index.js
的文件,并复制粘贴如下的代码:
var express = require("express");
var app = express();
app.use(express.json());
app.post("/adder", function(req, res) {
const num1 = req.body.num1;
const num2 = req.body.num2;
const response = { result: num1 + num2 };
res.status(200).send(JSON.stringify(response));
});
app.get("/doubler/:num", function(req, res) {
const num = req.params.num;
const response = { result: num * 2 };
res.status(200).send(JSON.stringify(response));
});
var server = app.listen(5000, function () {
console.log("app running on port:", server.address().port);
});
可以看到,代码非常简单直接。我们只是使用ExpressJS创建了一个HTTP服务器并监听5000端口。
如前文所示,服务器包含了两个端点:
POST
的body中接收到两个数字,即num1
和num2
,接下来所做的就是返回这两个数字的和。对于服务来讲,我们做这些就已经足够了。
要运行服务,我们只需执行如下的命令即可:
node index.js
非常好!我们已经让REST服务启动并运行了起来。接下来,我们要启动Space Cloud并通过GraphQL来使用REST服务。
我们需要为自己的操作系统下载Space Cloud二进制文件,也可以通过其源码直接进行构建。如果从源码构建的话,需要go 1.13.0或更高版本。
可以通过以下链接下载对应操作系统的二进制文件:
下载后,我们需要解压压缩包。
对于Linux/Mac:unzip space-cloud.zip && chmod +x space-cloud
对于Windows:右键点击压缩包并选择“解压到此处”。
为了确保二进制文件的正确性,在二进制文件的解压目录下,运行如下的命令:
对于Linux/Mac:./space-cloud -v
对于Windows:space-cloud.exe -v
它将会展现如下的输出:
space-cloud-ee version 0.13.0
要以dev
模式启动Space Cloud,可以复制粘贴如下的命令并点击回车键:
对于Linux/Mac:./space-cloud run --dev
对于Windows:space-cloud.exe run --dev
在Space Cloud启动的时候,我们会看到如下所示的输出:
Creating a new server with id auto-1T5fA9E1B2jeNUbV8R0fOPubRng
Starting http server on port: 4122
Hosting mission control on http://localhost:4122/mission-control/
Space cloud is running on the specified ports :D
注意:
--dev
标记会告诉Space Cloud以dev模式运行(所以,admin UI不会要求输入用户名和密码)。
我们可以注意到,Space Cloud在工作目录生成了一个config.yaml
文件。
Space Cloud需要该文件来完成它的功能。这个文件用来加载一些信息,包括要连接的REST服务器以及它们的端点。
Space Cloud有自己的Mission Control(admin UI),借助它能够快速完成配置。
导航至http://localhost:4122/mission-control,可以打开Mission Control。
注意:如果你不是在本地Space Cloud的话,那么需要将
localhost
替换为实际的地址。
点击Create a Project
按钮打开如下的界面:
为你的项目设置一个name
。
在这里选择什么数据库无关紧要,因为我们不会用到它。
点击Next
创建项目。
导航至Mission Control的Remote Services
区域。
点击Add first remote service
按钮来打开如下的表单:
将服务名设置为arithmetic
,并将服务的URL设置为:
http://localhost:5000
添加完远程服务之后,在远程服务的表格中,我们应该就能看到它:
点击Actions列中的Add
按钮,将会打开服务页面。
点击Add first remote endpoint
按钮以打开如下所示的表单:
为求和计算端点添加如下的内容:
adder
POST
/adder
再次点击“Add”按钮并添加doubler
端点:
doubler
GET
/doubler/{args.num}
注意:现在不要担心
{args.num}
部分,只需要确保将Method设置为GET
即可。
现在,我们已经添加了REST和两个端点到Space Cloud中,接下来,我们该使用统一的GraphQL API对其进行查询。
跳转至Explorer
区域:
尝试在GraphiQL explorer中运行如下的GraphQL查询:
{
adder(num1: 10, num2: 20) @arithmetic {
result
}
}
将会看到如下所示的响应:
{
"adder": {
"result": 30
}
}
在得到上述GraphQL查询后,Space Cloud会向REST服务发送如下的请求:
POST
/adder
{
"num1": 10,
"num2": 20
}
这意味着我们传递给GraphQL查询的参数以请求体的形式传递给了REST服务。
接下来,我们尝试使用如下的GraphQL查询来访问doubler
端点:
{
doubler(num: 50) @arithmetic {
result
}
}
GraphQL查询会被Space Cloud翻译成为对REST的调用,如下所示:
GET /doubler/50
如果你还记得的话,我们添加到Space Cloud的doubler端点是这样的:
/doubler/{args.num}
基于该端点,Space Cloud能够知道它要从GraphQL中获取一个参数num
,并使用它作为变量来形成路径/doubler/50
。
成功调用之后,我们应该会看到如下所示的响应:
{
"doubler": {
"result": 100
}
}
如果成功遵循这个指南的话,我们会有一个应得的奖励!这个REST到GraphQL的转换为我们解锁了一个超级强大的功能:服务链(Service Chaining)。
让我们来看一个场景:
如果我们在客户端代码中使用REST的话,上述任务将会如下所示:
请注意,我们从前端发出两个请求,就意味着往返时间会翻倍。它会导致较慢的响应时间和较差的用户体验。
现在,如果我们将客户端从REST切换为使用Space Cloud的GraphQL,那么我们的请求将会如下所示:
请注意,在这里,我们只从前端发起了一次GraphQL查询到后端(Space Cloud)。而Space Cloud发起了两次请求到REST服务器以满足该请求。但是,这些请求(从Space Cloud到我们的服务器)的往返时间是微不足道的,因为它们位于同一个网络中。
要完成上述任务,到Space Cloud的GraphQL查询如下所示:
{
adder(num1: 10, num2: 20) @arithmetic {
doubler(num: "adder.result") @arithmetic {
result
}
}
}
请注意,我们是如何在得到adder
服务的响应之后调用doubler
服务的,而且我们将adder
服务的result
以参数的形式传递给doubler
服务。
查询的结果将会如下所示:
{
"adder": {
"doubler": {
"result": 60
}
}
}
我们可以猜到,我们得到的结果是60,即(10 + 20) * 2。
小提示:如果你想并行执行两个不相关的REST服务的话,我们可以在一个请求中完成,如下所示:
{
adder(num1: 10, num2: 20) @arithmetic {
result
}
doubler(num: 50) @arithmetic {
result
}
}
我把这个查询会得到什么响应作为作业留给读者。
首先,鼓励一下你自己,因为你完整地读完了该指南。
通过该指南,我们学习到:
除了从REST迁移到GraphQL(如跨数据库连接)之外,我们还可以使用Space Cloud做更多的事情。如果你喜欢它的话,请在GitHub上为其添加一个star。