首页 > 资讯 > > 正文

我为什么要放弃RESTful,选择拥抱GraphQL

2023-02-14 01:56:53 来源:腾讯云

背景

REST作为一种现代网络应用非常流行的软件架构风格,自从Roy Fielding博士在2000年他的博士论文中提出来到现在已经有了20年的历史。它的简单易用性,可扩展性,伸缩性受到广大Web开发者的喜爱。


(资料图片)

REST 的 API 配合JSON格式的数据交换,使得前后端分离、数据交互变得非常容易,而且也已经成为了目前Web领域最受欢迎的软件架构设计模式。

但随着REST API的流行和发展,它的缺点也暴露了出来:

滥用REST接口,导致大量相似度很高(具有重复性)的API越来越冗余。对于前端而言:REST API粒度较粗,难以一次性符合前端的数据要求,前端需要分多次请求接口数据。增加了前端人员的工作量。对于后端而言:前端需要的数据往往在不同的地方具有相似性,但却又不同,比如针对同样的用户信息,有的地方只需要用户简要信息(比如头像、昵称),有些地方需要详细的信息,这就需要开发不同的接口来满足这些需求。当这样的相似但又不同的地方多的时候,就需要开发更多的接口来满足前端的需要。增加了后端开发人员的工作量和重复度。

那我们来分析一下,当前端需求变化,涉及到改动旧需求时,会有以下这些情况:

「做加法:」

产品需求增加,页面需要增加功能,数据也就相应的要增加显示,那么REST接口也需要做增加,这种无可厚非。

「做减法:」

产品需求减少,页面需要减少功能,或者减少某些信息显示,那么数据就要做减法。

一种通常懒惰的做法是,前端不与后端沟通,仅在前端对数据选择性显示。

因为后端接口能够满足数据需要,仅仅是在做显示的时候对数据进行了选择性显示,但接口的数据是存在冗余的,这种情况一个是存在数据泄露风险,另外就是数据量过大时造成网络流量过大,页面加载缓慢,用户流量费白白消耗,用户体验就会下降。

另外一种做法就是告知后端,要么开发新的接口,要么,修改旧接口,删掉冗余字段。

但一般来说,开发新接口往往是后端开发人员会选择的方案,因为这个方案对现有系统的影响最低,不会有额外的风险。

修改旧接口删除冗余数据的方案往往开发人员不会选择,这是为什么呢?

这就涉及到了系统的稳定性问题了,旧接口往往不止是一个地方在用,很有可能很多页面、设置不同客户端、不同服务都调用了这个接口获取数据,不做详细的调查,是不可能知道到底旧接口被调用了多少次,一旦改动旧接口,涉及范围可能非常大,往往会引起其他地方出现崩溃。改动旧接口成本太高,所以往往不会被采取。

「同时做加减法:」

既有加法,又有减法,其实这种就跟新需求没啥区别,前端需要重做页面,后端需要新写接口满足前端需要,但是旧接口还是不能轻举妄动(除非确定只有这一处调用才可以删除)。

往往这个时候,其实用到的数据大多都是来自于同一个DO或者DTO,不过是在REST接口组装数据时,用不同的VO来封装不同字段,或者,使用同样的VO,组装数据时做删减。

看到这些问题是不是觉得令人头大?

所以需求频繁改动是万恶之源,当产品小哥哥改动需求时,程序员小哥哥可能正提着铁锹赶来......

那么有没有一种方案或者框架,可以使得在用到同一个领域模型(DO或者DTO)的数据时,前端对于这个模型的数据字段需求的改动,后端可以根据前端的改动和需要,自动适配,自动组装需要的字段,返回给前端呢?如果能这样做的话,那么后端程序猿小哥可能要开心死了,前端妹子也不用那么苦口婆心地劝说后端小哥哥了。

所以GraphQL隆重出世了!那么问题来了!

Part 1 What is GraphQL

GraphQL简介

GraphQL是一种新的API标准,它提供了一种比REST更有效、更强大和更灵活的替代方案。它是由Facebook开发并开源的,现在由来自世界各地的公司和个人组成的大型社区维护。GraphQL本质上是一种基于api的查询语言,现在大多数应用程序都需要从服务器中获取数据,这些数据存储可能存储在数据库中,API的职责是提供与应用程序需求相匹配的存储数据的接口。它是数据库无关的,而且可以在使用API的任何环境中有效使用,我们可以理解为GraphQL是基于API之上的一层封装,目的是为了更好,更灵活的适用于业务的需求变化。

简单的来说,它

它的工作模式是这样子的:

GraphQL 对比 REST API 有什么好处?

REST API 的接口灵活性差、接口操作流程繁琐,GraphQL 的声明式数据获取,使得接口数据精确返回,数据查询流程简洁,照顾了客户端的灵活性。

客户端拓展功能时要不断编写新接口(依赖于服务端),GraphQL 中一个服务仅暴露一个 GraphQL 层,消除了服务器对数据格式的硬性规定,客户端按需请求数据,可进行单独维护和改进。

REST API 基于HTTP协议,不能灵活选择网络协议,而传输层无关、数据库技术无关使得 GraphQL 有更加灵活的技术栈选择,能够实现在网络协议层面优化应用。

举个经典的例子:前端向后端请求一个book对象的数据及其作者信息。

我用动图来分别演示下REST和GraphQL是怎么样的一个过程。

先看REST API的做法:

REST API获取数据

再来看GraphQL是怎么做的:

GraphQL获取数据

可以看出其中的区别:

与REST多个endpoint不同,每一个的 GraphQL 服务其实对外只提供了一个用于调用内部接口的端点,所有的请求都访问这个暴露出来的唯一端点。

Endpoints对比

REST API"s Endpoints

GraphQL 实际上将多个 HTTP 请求聚合成了一个请求,将多个 restful 请求的资源变成了一个从根资源 POST 访问其他资源的 Comment 和 Author 的图,多个请求变成了一个请求的不同字段,从原有的分散式请求变成了集中式的请求,因此GraphQL又可以被看成是图数据库的形式。

图数据库模式的数据查询

那我们已经能看到GraphQL的先进性,接下来看看它是怎么做的。

GraphQL 思考模式

使用GraphQL接口设计获取数据需要三步:

GraphQL获取数据三步骤

首先要设计数据模型,用来描述数据对象,它的作用可以看做是VO,用于告知GraphQL如何来描述定义的数据,为下一步查询返回做准备;前端使用模式查询语言(Schema)来描述需要请求的数据对象类型和具体需要的字段(称之为声明式数据获取);后端GraphQL通过前端传过来的请求,根据需要,自动组装数据字段,返回给前端。

GraphQL的这种思考模式是不是完美解决了之前遇到的问题呢?!

总结它的好处:

在它的设计思想中,GraphQL 以图的形式将整个 Web 服务中的资源展示出来,客户端可以按照其需求自行调用,类似添加字段的需求其实就不再需要后端多次修改了。

创建GraphQL服务器的最终目标是:

允许查询通过图和节点的形式去获取数据。

是什么让我放弃了restful api?了解清楚后我全面拥抱GraphQL

GraphQL执行逻辑

有人会问:

使用了GraphQL就要完全抛弃REST了吗?GraphQL需要直接对接数据库吗?使用GraphQL需要对现有的后端服务进行大刀阔斧的修改吗?

答案是:NO!不需要!

它完全可以以一种不侵入的方式来部署,将它作为前后端的中间服务,也就是,现在开始逐渐流行的 前端 —— 中端 —— 后端 的三层结构模式来部署!

那就来看一下这样的部署模式图:

GraphQL执行逻辑

也就是说,完全可以搭建一个GraphQL服务器,专门来处理前端请求,并处理后端服务获取的数据,重新进行组装、筛选、过滤,将完美符合前端需要的数据返回。

新的开发需求可以直接就使用GraphQL服务来获取数据了,以前已经上线的功能无需改动,还是使用原有请求调用REST接口的方式,最低程度的降低更换GraphQL带来的技术成本问题!

如果没有那么多成本来支撑改造,那么就不需要改造!

只有当原有需求发生变化,需要对原功能进行修改时,就可以换成GraphQL了。

GraphQL应用的基本架构

下图是一个 GraphQL 应用的基本架构,其中客户端只和 GraphQL 层进行 API 交互,而 GraphQL 层再往后接入各种数据源。这样一来,只要是数据源有的数据, GraphQL 层都可以让客户端按需获取,不必专门再去定接口了。

GraphQL应用基本架构

一个GraphQL服务仅暴露一个 GraphQL Endpoint,可以按照业务来进行区分,部署多个GraphQL服务,分管不同的业务数据,这样就可以避免单服务器压力过大的问题了。

GraphQL特点总结

声明式数据获取(可以对API进行查询): 声明式的数据查询带来了接口的精确返回,服务器会按数据查询的格式返回同样结构的 JSON 数据、真正照顾了客户端的灵活性。一个微服务仅暴露一个 GraphQL 层:一个微服务只需暴露一个GraphQL endpoint,客户端请求相应数据只通过该端点按需获取,不需要再额外定义其他接口。传输层无关、数据库技术无关:带来了更灵活的技术栈选择,比如我们可以选择对移动设备友好的协议,将网络传输数据量最小化,实现在网络协议层面优化应用。

Part 2 Schema & Type

GraphQL支持的数据操作

GraphQL对数据支持的操作有:

查询(Query):获取数据的基本查询。变更(Mutation):支持对数据的增删改等操作。订阅(Subscription):用于监听数据变动、并靠websocket等协议推送变动的消息给对方。

GraphQL支持的操作

GraphQL的核心概念:图表模式(Schema)

要想要设计GraphQL的数据模型,用来描述你的业务数据,那么就必须要有一套Schema语法来做支撑。

想要描述数据,就必须离不开数据类型的定义。所以GraphQL设计了一套Schema模式(可以理解为语法),其中最重要的就是数据类型的定义和支持。

那么类型(Type)就是模式(Schema)最核心的东西了。

什么是类型?

对于数据模型的抽象是通过类型(Type)来描述的,每一个类型有若干字段(Field)组成,每个字段又分别指向某个类型(Type)。这很像Java、C#中的类(Class)。GraphQL的Type简单可以分为两种,一种叫做Scalar Type(标量类型),另一种叫做Object Type(对象类型)。

那么就分别来介绍下两种类型。

标量类型(Scalar Type)

标量是GraphQL类型系统中最小的颗粒。类似于Java、C#中的基本类型。

其中内建标量主要有:

StringIntFloatBooleanEnumID

Scalar Type

上面的类型仅仅是GraphQL默认内置的类型,当然,为了保证最大的灵活性,GraphQL还可以很灵活的自行创建标量类型。

对象类型(Object Type)

仅有标量类型是不能满足复杂抽象数据模型的需要,这时候我们可以使用对象类型。

通过对象模型来构建GraphQL中关于一个数据模型的形状,同时还可以声明各个模型之间的内在关联(一对多、一对一或多对多)。

对象类型的定义可以参考下图:

对象模型引入关联关系

是不是很方便呢?我们可以像设计类图一样来设计GraphQL的对象模型。

类型修饰符(Type Modifier)

那么,类型系统仅仅只有类型定义是不够的,我们还需要对类型进行更广泛性的描述。

类型修饰符就是用来修饰类型,以达到额外的数据类型要求控制。

比如:

列表:[Type]非空:Type!列表非空:[Type]!非空列表,列表内容类型非空:[Type!]!

在描述数据模型(模式Schema)时,就可以对字段施加限制条件。

例如定义了一个名为User的对象类型,并对其字段进行定义和施加限制条件:

User字段控制

那么,返回数据时,像下面这种情况就是不允许的:

错误的表示

Graphql会根据Schema Type来自动返回正确的数据:

正确的表示

其他类型

除了上面的,Graphql还有一些其他类型来更好的引入面向对象的设计思想:

接口类型(Interfaces):其他对象类型实现接口必须包含接口所有的字段,并具有相同的类型修饰符,才算实现接口。

比如定义了一个接口类型:

那么就可以实现该接口:

联合类型(Union Types):联合类型和接口十分相似,但是它并不指定类型之间的任何共同字段。几个对象类型共用一个联合类型。
输入类型(Input Types):更新数据时有用,与常规对象只有关键字修饰不一样,常规对象时 type 修饰,输入类型是 input 修饰。

比如定义了一个输入类型:

前端发送变更请求时就可以使用(通过参数来指定输入的类型):

所以,这样面向对象的设计方式,真的对后端开发人员特别友好!而且前端MVVM框架流行以来,面向对象的设计思想也越来越流行,前端使用Graphql也会得心应手。

Part 3 GraphQL技术接入架构

Graphql 技术接入架构

那么,该怎么设计来接入我们现有的系统中呢?

将Graphql服务直连数据库的方式:最简洁的配置,直接操作数据库能减少中间环节的性能消耗。

直连数据库的接入

集成现有服务的GraphQL层:这种配置适合于旧服务的改造,尤其是在涉及第三方服务时、依然可以通过原有接口进行交互。

集成现有服务的GraphQL层

直连数据库和集成服务的混合模式:前两种方式的混合。

混合接入方式

可以说是非常灵活了!你都不用担心会给你带来任何的麻烦。

服务端实现

在服务端, GraphQL 服务器可用任何可构建 Web 服务器的语言实现。有以下语言的实现供参考:

C# / .NETClojureElixirErlangGoGroovyJavaJavaScriptJuliaKotlinPerlPHPPythonRRubyRustScalaSwift

种类繁多,几乎流行的语言都有支持。

客户端实现

在客户端,Graphql Client目前有下面的语言支持:

C# / .NETClojurescriptElmFlutterGoJava / AndroidJavaScriptJuliaSwift / Objective-C iOSPythonR

覆盖了众多客户端设计语言,而其他语言的支持也在推进中。

Graphql的一些服务

整理了下目前比较流行的服务框架:

Apollo Engine:一个用于监视 GraphQL 后端的性能和使用的服务。Graphcool (github): 一个 BaaS(后端即服务),它为你的应用程序提供了一个 GraphQL 后端,且具有用于管理数据库和存储数据的强大的 web ui。Tipe (github): 一个 SaaS(软件即服务)内容管理系统,允许你使用强大的编辑工具创建你 的内容,并通过 GraphQL 或 REST API 从任何地方访问它。AWS AppSync:完全托管的 GraphQL 服务,包含实时订阅、离线编程和同步、企业级安全特性以及细粒度的授权控制。Hasura:一个 BaaS(后端即服务),允许你在 Postgres 上创建数据表、定义权限并使用 GraphQL 接口查询和操作。

Graphql的一些工具

graphiql (npm): 一个交互式的运行于浏览器中的 GraphQL IDE。Graphql Language Service: 一个用于构建 IDE 的 GraphQL 语言服务(诊断、自动完成等) 的接口。quicktype (github): 在 TypeScript、Swift、golang、C#、C++ 等语言中为 GraphQL 查 询生成类型。

想要获取更多关于Graphql的一些框架、工具,可以去awesome-graphql:一个神奇的社区,维护一系列库、资源等,地址是

https://github.com/chentsulin/awesome-graphql。

想要学习更多Graphql的知识,可以去GraphQL.cn。

好了,一个入门级的Graphql介绍篇就这样完结了(尽管篇幅也很大哈哈)。

不知道你懂得它的原理和优点了吗?你对它感兴趣吗?看完这篇介绍,有没有想动手尝试一下呢?你会在你下一个项目中引入Graphql并使用它吗?你对Graphql还有什么疑惑的问题呢?
标签: 微服务架构

道袍的颜色和等级分别-每日消息

道袍的颜色和等级分别,道袍有蓝色、灰色、黄色、棕色,暗红色,形制为:直领、大襟、右衽、大袖收口。...

2023-02-14 02:05:44

我为什么要放弃RESTful,选择拥抱GraphQL

REST作为一种现代网络应用非常流行的软件架构风格,自从RoyFielding博士在2000年他的博士论文中提出来到...

2023-02-14 01:56:53

剧本的特点是什么

剧本的特点是什么,剧本的特点:1、空间和时间要高度集中要求时间、人物、情节、场景高度集中在舞台范围...

2023-02-13 22:21:55

在上海1000万资产是穷人?董承非发言引热议 公司回应;腾讯视频回应多设备登录被封号丨大公司动态 今日热议

【科技圈】苹果联合创始人:ChatGPT不懂人性,可能犯下可怕错误据报道,苹果公司联合创始人沃兹尼亚克日...

2023-02-13 22:10:45

博实股份股东户数减少41户,户均持股75.58万元

博实股份最新股东户数1 82万户,低于行业平均水平。公司户均持有流通股份4 41万股;户均流通市值75 58万元。

2023-02-13 19:49:42

车辆管理制度

1、车辆管理制度是为了使车辆管理统一化,制度化,合理有效的调配和使用各种车辆,最大限度的节约成本,...

2023-02-13 17:50:50

NDC仿真功能,让AGV小车有“迹”可循

AGV小车是现代物流体系中不可或缺的工具,它熟练地穿梭于智能化系统仓库仓储、生产车间、工位及各段输送...

2023-02-13 16:03:18

天天热消息:送毕业生的礼物

毕业季,又是一次毕业生中毕业生的毕业季,送他们毕业礼物是一种纪念。毕业礼物,可以送给同桌毕业礼物...

2023-02-13 14:22:30

养一台马丁花多少钱?普通人还真养不起 DBX用车成本分析

如今大部分品牌都在做SUV,就连超豪华品牌也不例外,最近阿斯顿·马丁DBX(图片|配置|询价)的2024款上线...

2023-02-09 10:49:53

3-碘异硫氰酸苯酯|世界今日报

1、3-碘异硫氰酸苯酯是一种化学物质。2、化学式是C7H4INS。文章到此就分享结束,希望对大家有所帮助。

2023-02-09 10:05:57

键凯科技02月08日沪股通持有量66.23万股

02月08日,键凯科技被沪股通减持5531股,已连续7日被沪股通减持,共计32 71万股

2023-02-09 07:59:15

电信怎么查询流量 电信查询流量的方法

1、可以通过手机查询。编辑短信108,发送到10001,可以查询套餐,语音时长和短信流量等,发送和接收的短...

2023-02-09 07:55:49

天天看点:日本化妆品品牌有哪些 日本化妆品品牌

1、资生堂、SK-II、澳尔滨、黛珂、FANCL芳珂、高丝、芙丽芳丝、蝶翠诗DHC、za姬芮、雪肌精。2、资生堂,日本著

2023-02-09 04:59:57

平安夜祝福语带图片唯美文艺经典(2)

平安夜祝福语唯美图片1 平平安安是快乐的源泉,平平安安是幸福的基础,平平安安是如意的核心,平平安安...

2023-02-09 04:10:18

每日快报!招商策略:推荐关注景气度相对较高的汽车 钢材 沥青 出行等领域

招商策略近日研报认为,春节过后各项生产经营活动逐渐恢复,目前来看生产复工进度偏弱,上游资源品价格...

2023-02-09 01:56:31

热门:“很多人对洗烘一体机有误会”,售货员口中的优势,让我无力反驳

前些天逛家电市场,走到了洗衣机的展厅。售货员引导我去看洗烘一体机,却被我一口回绝了。在我的眼中,...

2023-02-08 23:57:43

卡通动物绘画图片大全

卡通通俗、幽默、风趣、夸张,很受人们的欢迎,那么你想知道卡通动物绘画图片有哪些吗?下面由学习啦小编...

2023-02-08 23:53:13

焦点消息!便秘“源头”终于找到了!烧开水撒1把,润肠通便,助肠道“一通到底”

“便秘不是病,解不出来真要命!”“太难受了,蹲在厕所里半天面红耳赤,腿脚发麻,然而还是拉不出来。...

2023-02-08 21:58:51

天天热点!事迹材料:优秀团支部事迹材料

我团支部以抓好自身建设为重点,按照践行当代军人核心价值观的总要求,在加强自身学习的同时,团支部积...

2023-02-08 19:59:22

云南省人社服务网上大厅社保证明在哪打印(附打印流程+入口)

云南省人社服务网上大厅办理网址:https: hrss yn gov cn:8090 personlogin personlogin可打印的参保类型:养老

2023-02-08 19:03:09

我是惆怅客 知君何事泪纵横_知君何事泪纵横

1、全句散发一种淡淡的惆怅,“我”还是“君”,其实都是指纳兰自己。2、纳兰词至情至性,词风哀感顽艳...

2023-02-08 17:57:53

当前快讯:常州外地人逗留香港首次办通行证材料有哪些

*特殊申请个案,以出入境管理部门解释为准。序号材料名称材料说明需要原件1申请表是2申请人有效的南京居...

2023-02-08 16:03:35

2017稻城亚丁自助游攻略|世界实时

稻城亚丁,位于四川甘孜自治州南部,因为其独特的风景和悠久的文化历史被誉为最后的香格里拉。下面是学...

2023-02-08 16:02:45

长期失眠多梦是什么原因_失眠多梦是什么原因 世界简讯

1、失眠多梦可能与人的精神紧张以及情绪因素有关系,有的人失眠时暂时性的,也有的人是长期的。2、一般...

2023-02-08 15:03:52

拜登发表国情咨文演讲 新视野

据大公报报道,据环球网报道,美东时间2月7日21时许,美国总统拜登在美国会大厦发表就任总统以来的第二...

2023-02-08 12:55:42

轻舟已过万重山美文欣赏 热门看点

13岁男孩体育考18分被父亲误伤,警醒父母:教育不是吓唬而是帮助

总胆红素和间接胆红素偏高是啥问题呀

水浒传的作者是谁_水浒传是谁写的 每日看点

焦点快看:四年级数学第一单元上册的测试题

【全球热闻】Kevin Tan

在农村养殖什么可以赚钱致富 这些项目都非常不错 快看点

Maya 2008完全自学教程

每日视讯:春晚几点结束2022_春晚几点结束

每日速读!桑叶可以做菜吃吗

东京奥运会羽毛球混双冠军_东京奥运会羽毛球_今亮点

寂地经典语录 每日快讯

新锐股份: 新锐股份2023年股权激励计划授予激励对象名单(截至授予日) 新视野

西门豹治邺复述经过和结果的部分_西门豹治邺复述

武汉再发“房票”?房产交易中心:为之前政策的延续 天天最新

刑警2010结局

张昊玥《人设》今日开播 化身黑玫瑰追梦演艺圈-全球通讯

一个人活成一支队伍_焦点简讯

腾势汽车与腾讯SSV达成战略合作_热点评

岳飞论马文言文阅读答案_岳飞论马|热资讯

Meta CTO最近表示,面部捕捉距离消费级VR头显尚有时日 世界观速讯

天津跨境电商业务快速发展|天天速看料

头条焦点:多数灵活就业者称,缴纳社保不如自己存款养老,什么原因导致的?

环球关注:土耳其华人讲述地震恐怖经历详细内容

世界球精选!长三角铁路建设全面复工,基建投资连续7年保持800亿元以上

x 广告
x 广告

Copyright @  2015-2022 华中家电网版权所有  备案号: 京ICP备12018864号-26   联系邮箱:2 913 236 @qq.com