写点什么

分分钟将 REST 转换为 GraphQL

2020 年 2 月 22 日

分分钟将REST转换为GraphQL

这个指南教你在不修改任何代码的情况下,完成从 REST 到 GraphQL 的迁移。这样,GraphQL 就能让你的 REST 真正休息一下了!


从 REST 到 GraphQL


GraphQL 的支持者在宣传推广GraphQL方面已经做得非常好了。出于对他们努力的尊重,我就不再深入介绍细节,只是稍微总结一下:


  1. GraphQL 允许我们在单个请求中获取多个资源;

  2. 通过精确描述所需数据,GraphQL 解决了 REST 过度抓取数据的问题;

  3. GraphQL 借助在一个请求中获取相关的数据,解决了前端 N+1 查询的问题。


本指南中,我会介绍大多数倡导 GraphQL 的人所忽略的一个点,就是“我们在 REST 上有了巨大投入”。这意味着:


  • 我们大多数的服务都是基于 REST 的;

  • 我们更愿意编写 REST 服务;

  • 我们希望支持使用 REST API 的现有客户端。


虽然有许多文章帮我们从 REST 迁移到 GraphQL,但这些做法都迫使我们更改现有的代码库或在 REST 服务前面编写新的代码库。


但是,稍等一下……


如果它还能运行,就别去碰它。


这难道不是编程的第一规则吗?


迁移可能非常痛苦,尤其是面对巨大的代码库时,更会令人望而生畏。随时存在将已有功能破坏掉的可能性。


我们为什么不能继续保持 REST 呢?我们天性懒惰,都喜欢用简单的技巧和容易的解决方案。


如果有一种方式,让我们原样保持 REST 服务,且无需任何代码变更就能在其之上实现一个 GraphQL 层,那会怎样?听起来很神奇,Space Cloud就能帮我们实现这一切


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 不会破坏旧的客户端。


接下来,让我们开始。


我们将要构建什么?


本指南中,我们将会构建一个简单的算数服务,它包含如下端点:


  • 求和计算端点POST /adder

  • 翻倍计算端点GET /doubler/:num


求和计算端点将会返回两个数的和,这两个数是通过请求的body获取到的。翻倍计算端点将会对其接收到的值翻倍,初始值是通过 URL 路径参数获取到的。


现在,开始构建


第一步:编写服务


现在,我们开始编写 REST 服务。在这里,我们使用 NodeJS 和 Express 来编写 REST 服务。


注意:你可以使用任意语言和框架来编写服务,只要它支持 HTTP 即可,因为这是 Space Cloud 用来与你的 REST 服务进行通信的协议。


首先,创建一个文件夹作为工作目录。


创建 NPM 项目


npm init -y
复制代码


安装 Express


npm install --save express
复制代码


编写 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 中接收到两个数字,即num1num2,接下来所做的就是返回这两个数字的和。

  • 翻倍计算端点:我们将通过 URL 路径参数得到的数字乘以 2,然后返回。


对于服务来讲,我们做这些就足够了。


第二步:启动服务


要运行服务,我们只需执行如下命令即可:


node index.js
复制代码


我们让 REST 服务启动并运行了起来。接下来,启动 Space Cloud 并通过 GraphQL 来使用 REST 服务。


第三步:下载 Space Cloud


我们需要为自己的操作系统下载 Space Cloud 二进制文件,也可以通过其源码直接进行构建。如果从源码构建的话,需要 go 1.13.0 或更高版本。


可以通过以下链接下载对应操作系统的二进制文件:



下载后,我们解压压缩包。


对于 Linux/Macunzip space-cloud.zip && chmod +x space-cloud


对于 Windows:右键点击压缩包并选择“解压到此处”。


为确保二进制文件的正确性,在二进制文件的解压目录下,运行如下命令:


对于 Linux/Mac./space-cloud -v


对于 Windowsspace-cloud.exe -v


它将会展现如下输出:


space-cloud-ee version 0.13.0
复制代码


第四步:下载 Space Cloud


要以dev模式启动 Space Cloud,可以复制粘贴如下命令并点击回车键:


对于 Linux/Mac./space-cloud run --dev


对于 Windowsspace-cloud.exe run --dev


在 Space Cloud 启动时,我们会看到如下所示的输出:


Creating a new server with id auto-1T5fA9E1B2jeNUbV8R0fOPubRngStarting 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


我们注意到,Space Cloud 在工作目录生成一个config.yaml文件。


Space Cloud 需要该文件来完成它的功能。这个文件用来加载一些信息,包括要连接的 REST 服务器以及它们的端点。Space Cloud 有自己的 Mission Control(admin UI),借助它能够快速完成配置。


打开 Mission Control


导航至 http://localhost:4122/mission-control,可以打开 Mission Control。


注意:如果你不是在本地 Space Cloud 的话,那么需要将localhost替换为实际地址。


创建项目


点击Create a Project按钮,打开如下界面:



为你的项目设置一个name


在这里选择什么数据库无关紧要,因为我们不会用到它。


点击Next创建项目。


第六步:添加远程服务到 Space Cloud 中


导航至 Mission Control 的Remote Services区域。


点击Add first remote service按钮来打开如下的表单:



将服务名设置为arithmetic,并将服务的 URL 设置为:


http://localhost:5000
复制代码


添加完远程服务之后,在远程服务的表格中,我们应该就能看到它:



点击 Actions 列中的Add按钮,将会打开服务页面。


点击Add first remote endpoint按钮,打开如下所示表单:



为求和计算端点添加如下内容:


  • Name:adder

  • Method:POST

  • Path:/adder


再次点击“Add”按钮并添加doubler端点:


  • Name:doubler

  • Method:GET

  • Path:/doubler/{args.num}


注意:现在不要担心{args.num}部分,只需要确保将 Method 设置为GET即可。


第七步:通过 GraphQL 来查询 REST 服务


现在,我们添加了 REST 和两个端点到 Space Cloud 中,接下来,我们该使用统一的 GraphQL API 对其进行查询。


跳转至Explorer区域:



尝试在 GraphiQL explorer 中运行如下的 GraphQL 查询:


{  adder(num1: 10, num2: 20) @arithmetic {    result  }}
复制代码


将会看到如下所示的响应:


{  "adder": {    "result": 30  }}
复制代码


在得到上述 GraphQL 查询后,Space Cloud 会向 REST 服务发送如下的请求:


  • Method:POST

  • Path:/adder

  • Request Body:


{  "num1": 10,  "num2": 20}
复制代码


这意味着我们传递给 GraphQL 查询的参数以 Request Body 的形式传递给了 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)。


让我们来看一个场景:


  • 我们想要使用 the adder service 对两个数字求和;

  • 我们想把从 the adder service 得到的结果翻倍。


REST 方式


如果我们在客户端代码中使用 REST 的话,上述任务将会如下所示:



注意,我们从前端发出两个请求,就意味着往返时间会翻倍。它会导致较慢的响应时间和较差的用户体验。


GraphQL 方式


现在,如果我们将客户端从 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 不需要更改代码。

  • 我们不需要在 REST 和 GraphQL 之间进行非此即彼的选择。我们可以在同一个应用程序中同时支持 REST 和 GraphQL。

  • 借助 Space Cloud 来使用 GraphQL 会带来网络方面的收益,有助于减少往返时间。


除了从 REST 迁移到 GraphQL(如跨数据库连接)之外,我们还可以用Space Cloud做更多事情。


相关阅读:


https://dzone.com/articles/rest-to-graphql-in-minutes


2020 年 2 月 22 日 08:009400
用户头像
张卫滨 业精于勤,行成于思。

发布了 369 篇内容, 共 209.7 次阅读, 收获喜欢 246 次。

关注

评论

发布
暂无评论
发现更多内容

「深度解析」告诉你如何选择容器存储

焱融科技

Kubernetes 云原生 焱融科技 容器存储 分布式文件存储

小程序云开发实战:从0搭建科技爱好者周刊小程序

薛定喵君

微信小程序 小程序云开发 云开发

个人计算机、工作站、服务器的主要区别

德胜网络-阳

币币交易所开发,区块链交易系统源码

135深圳3055源中瑞8032

WebSocket-技术专题-服务器端消息推送

李浩宇/Alex

API生态的发展与机遇:从5000组数据看中国API生态与开发者现状

华为云开发者社区

华为 API

MySql从青铜到王者晋级之路,阿里大牛经验总结让牛少走弯路!

Java架构之路

Java 程序员 架构 面试 编程语言

你用过宏##粘贴函数,然后用函数指针查找执行吗?今天就给你说道说道

良知犹存

c c++

架构师训练营第六周作业

Geek_4c1353

搜狗搜索或成为企鹅号流量入口:腾讯欲实现自己的流量闭环

石头IT视角

接口测试工具

测试人生路

接口文档 接口测试

大企程序员亲身经历告诉你,CRM系统,自己的才是最好的

Learun

敏捷开发

anyRTC与京东智联云市场达成战略合作,携手音视频平台

anyRTC开发者

ios 音视频 WebRTC RTC 安卓

程序员不愿意说的秘密!Java进阶架构师必看:架构完美设计+程序员三门课+架构修炼之道

Java架构追梦

爬虫“学前班”,记住这些不踩坑!

华为云开发者社区

爬虫 数据 搜索

java安全编码指南之:文件IO操作

程序那些事

java安全编码 java安全 java安全编码指南 java代码规范

我服了,难倒无数程序员的源码面试,就这样被轻轻松松讲透彻

小Q

Java 学习 源码 架构 面试

数字货币钱包开发,去中心化钱包源码搭建

135深圳3055源中瑞8032

合约一键智能跟单软件,跟单平台开发

135深圳3055源中瑞8032

如何生成 Flink 作业的交互式火焰图?

Apache Flink

flink

分布式文件存储QoS硬核黑科技,真香

焱融科技

高性能 存储 HPC 分布式文件存储 QoS

以A.I.之力打破方言沟通障碍 科大讯飞重磅发布智慧翻译系统

Talk A.I.

来自朋友最近阿里、腾讯、美团等P7岗位面试题

艾小仙

Java 阿里巴巴 程序员 腾讯 面试

数字货币交易所开发,去中心化交易所平台搭建

WX13823153201

数字货币交易所开发

openEuler开源下一代全场景虚拟化平台StratoVirt

openEuler

开源 虚拟化 openEuler stratovirt

USDT支付入金系统开发搭建,跨境USDT支付系统开发

135深圳3055源中瑞8032

云原生时代 容器持久化存储的最佳方式是什么?

京东科技开发者

数据库 云存储

uni-app支持PC宽屏适配

崔红保

uni-app 前端框架

最近程序员频繁被抓,如何避免面向监狱编程!?

Java架构师迁哥

云开发·多次订阅一次性订阅消息后定时发送

Yukun

微信小程序 小程序云开发 消息推送 订阅消息

基于阿里云容器的CI/CD落地实践

LorraineLiu

阿里云 k8s Helm jenkins CI/CD

分分钟将REST转换为GraphQL-InfoQ