文档章节

灵活的API查询语言——GraphQL

Linux就该这么学
 Linux就该这么学
发布于 2018/11/07 16:20
字数 1090
阅读 57
收藏 2

本文简单的介绍了 GraphQL,希望能够帮助大家对这个方便的查询语言有一个简单的认识

GraphQL 是什么

GraphQL 是一种 API 查询语言,是一个对自定义类型系统执行查询的服务端运行环境。它相当于客户端和服务器之间的中介,将客户端发来的所需数据的请求处理之后在一次请求之中就能获得符合客户端需求的响应数据。它还有个好处就是它是一种当作一种组织,管理数据的能力来使用,而不绑定在什么数据库上面,数据存在于哪里与它无关。

对比 Rest API

Rest API 是和 GraphQL 同类的用于查询的语言。Rest 把每个资源都用一个 URL 表示,访问这个 URL 就能够得到一份 JSON 格式的数据响应,但是这有一个缺点,你可能会得到与需求不相关的数据。而 GraphQL 则不会,发送过去的请求中指定了需要哪个资源,举个简单的例子,你需要这本书的作者的姓资源,那么 Rest API 会把把作者的名字也发给你,因为你是通过访问作者的信息的 URL 来获得姓的,而 GraphQL 则会只把需要的信息发过来,换句话说,需要什么资源是用户来决定的。

RPC vs REST vs GraphQL(参考资料点击这里

灵活的API查询语言——GraphQL灵活的API查询语言——GraphQL

在合适的时候选择合适的工具是重要的,下面则列举了在一些场景下最好使用什么工具来作为参考

1、如果是 Management API,这类 API 的特点如下:

  • 关注于对象与资源
  • 会有多种不同的客户端
  • 需要良好的可发现性和文档
  • 这种情景使用 REST + JSON API 可能会更好。

2、如果是 Command or Action API,这类 API 的特点如下:

  • 面向动作或者指令
  • 仅需要简单的交互
  • 这种情况使用 RPC 就足够了。

3、如果是 Internal Micro Services API,这类 API 的特点如下:

  • 消息密集型
  • 对系统性能有较高要求
  • 这种情景仍然建议使用 RPC。

4、如果是 Micro Services API,这类 API 的特点如下:

  • 消息密集型
  • 期望系统开销较低
  • 这种情景使用 RPC 或者 REST 均可。

5、如果是 Data or Mobile API,这类 API 的特点是:

  • 数据类型是具有图状的特点
  • 希望对于高延迟场景可以有更好的优化
  • 这种场景无疑 GraphQL 是最好的选择。

GraphQL 的查询与变更——如何查询 GraphQL 服务器
以一个查询结果为例:

{
hero {
name
}
}

该查询将会获得一个与其结构几乎一样的结果:

{
"data": {
"hero": {
"name": "R2-D2"
}
}
}

这是 GraphQL 最重要的特性,因为这样一来,你就总是能得到你想要的数据,而服务器也准确地知道客户端请求的字段。并且在GraphQL中查询是可交互的,你可以按你喜欢来改变查询,然后看看新的结果。

在查询时可以添加上参数,结果也会显得更有趣。参数可以是多种不同的类型。GraphQL 自带一套默认类型,但是 GraphQL 服务器可以声明一套自己的定制类型,只要能序列化成你的传输格式即可。

例如,有如下查询:

{
human(id: "1000") {
name
height
}
}

其结果为:

{
"data": {
"human": {
"name": "Luke Skywalker",
"height": 1.72
}
}
}

在类似 REST 的系统中,你只能传递一组简单参数 —— 请求中的 query 参数和 URL 段。但是在 GraphQL 中,每一个字段和嵌套对象都能有自己的一组参数,从而使得 GraphQL 可以完美替代多次 API 获取请求。甚至你也可以给 标量(scalar)字段传递参数,用于实现服务端的一次转换,而不用每个客户端分别转换。

© 著作权归作者所有

Linux就该这么学
粉丝 24
博文 553
码字总数 460876
作品 0
东城
程序员
私信 提问
这才是GraphQL最详尽的解释

翻译:疯狂的技术宅 原文:opensource.com/article/19/… 未经允许严禁转载 GraphQL是一种查询语言、一种执行引擎和一种规范,它引领开发人员重新思考应该怎样去构建客户端和API。 GraphQL ...

前端先锋
06/13
0
0
以LeetCode为例——如何发送GraphQL Query获取数据

前言 GraphQL 是一种用于 API 的查询语言,是由 Facebook 开源的一种用于提供数据查询服务的抽象框架。在服务端 API 开发中,很多时候定义一个接口返回的数据相对固定,因此要获得更多信息或...

zxzhang
2018/07/19
0
0
GraphQL,高效、结构化与系统化的 REST 替代方案

在提及web API的时候,我们大多都会想到REST(表述性状态传递,Representational State Transfer)。你发送请求到一个特定请求的URL,然后你会收到结果,就像是HTML,XML,JSON,明文,PDF,...

oschina
2018/05/21
4.5K
10
GraphQL 基金会成立了:将托管于Linux 基金会管理

GraphQL 基金会在11月7日宣布成立,并将由 Linux 基金会管理。GraphQL 基金会将专用于完善和稳定 GraphQL 生态系统,让 GraphQL 得到广泛关注和采用。GraphQL 是 Facebook 开发的一个应用层数...

Linux就该这么学
2018/12/17
88
0
GraphQL 基金会成立,将交由 Linux 基金会管理

11月7日消息,GraphQL 基金会宣布成立,并将由 Linux 基金会管理。GraphQL 基金会将专用于完善和稳定 GraphQL 生态系统,让 GraphQL 得到广泛关注和采用。 GraphQL 是 Facebook 开发的一个应...

局长
2018/11/08
1K
5

没有更多内容

加载失败,请刷新页面

加载更多

500行代码,教你用python写个微信飞机大战

这几天在重温微信小游戏的飞机大战,玩着玩着就在思考人生了,这飞机大战怎么就可以做的那么好,操作简单,简单上手。 帮助蹲厕族、YP族、饭圈女孩在无聊之余可以有一样东西让他们振作起来!...

上海小胖
25分钟前
3
0
关于AsyncTask的onPostExcute方法是否会在Activity重建过程中调用的问题

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。 本文链接:https://blog.csdn.net/XG1057415595/article/details/86774575 假设下面一种情况...

shzwork
今天
7
0
object 类中有哪些方法?

getClass(): 获取运行时类的对象 equals():判断其他对象是否与此对象相等 hashcode():返回该对象的哈希码值 toString():返回该对象的字符串表示 clone(): 创建并返此对象的一个副本 wait...

happywe
今天
6
0
Docker容器实战(七) - 容器中进程视野下的文件系统

前两文中,讲了Linux容器最基础的两种技术 Namespace 作用是“隔离”,它让应用进程只能看到该Namespace内的“世界” Cgroups 作用是“限制”,它给这个“世界”围上了一圈看不见的墙 这么一...

JavaEdge
今天
8
0
文件访问和共享的方法介绍

在上一篇文章中,你了解到文件有三个不同的权限集。拥有该文件的用户有一个集合,拥有该文件的组的成员有一个集合,然后最终一个集合适用于其他所有人。在长列表(ls -l)中这些权限使用符号...

老孟的Linux私房菜
今天
7
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部