新一代数据查询语言GraphQL来啦

阅读量：2339 次

发布时间：2019-05-10

本文共 5639 字，大约阅读时间需要 18 分钟。

1. GraphQL来啦！

当Facebook构建移动应用的时候，它需要的是一个强大的数据获取API:

足够强大，满足Facebook自身复杂业务的需求；

足够简单，对开发者和使用者来说很容易上手与使用；

GraphQL就是为了满足这一个需求而产生的，Facebook从2012年开始完善，与2015年展开GraphQL的开源的进程，并形成一个。

GraphQL每天都为Fackbook接收、处理着上百亿的请求，为Fackbook提供了强大的基础数据平台的支持，滋养大量业务与产品。

2. 为什么是GraphQL？

回到2012年，Fackbook开始重构他们的本地移动应用。当时他们的和移动应用实际上是就是他们Web应用的内容再加上一个本地浏览器的壳。这看上去给他们带来了“一次开发，多端应用”的好处，但是随着Fackbook移动应用越来越复杂，这样的做法直接带来了极差的性能和时常发生的程序崩溃，所以他们开始开发真正的本地应用。

而当时 Facebook 现有的服务器主要功能还是只提供 HTML ，数据接口并不能直接复用，服务模式就是请求一个 URL ，返回一堆 HTML。而本地移动应用，为了给应用提供需要的数据，填充数据模型，显示视图，要解决的问题是怎么去请求，准备，传递这些数据。

Facebook考量了两种实现方案，包括RESTful服务资源和FQL表。

RESTful：对于Facebook这种复杂的应用，可能需要定义很多端点，这些数据接口可能只是返回字段有所不同，造成重复工作，同时难以表达复杂的逻辑；

FQL：FQL是Facebook类似于SQL的API，它功能强大、格式明确，但是查询的语言非常难以理解，例如一些数据表JOIN等操作。

Facebook工程师们希望能够在移动应用和服务端的查询达到一致，最后使用的模型可以类似于NSObjects或者JSON那样的结构。

几个工程师开始了现在的 GraphQL，一种用对象，属性来表示数据关系，有点像图形的方式来表达想要的数据。所以最终GraphQL给了产品设计人员和开发人员重新思考移动应用数据获取的机会，它将开发的重点转移到了客户端应用中，这里是设计师和开发人员最关注的地方。

3. 什么是GraphQL？

GraphQL是一种API查询语言，是一个对自定义类型系统执行查询的服务端运行环境

一个GraphQL查询是一个被发往服务端的字符串，该查询在服务端被解释和执行后返回JSON数据给客户端。

3.1 定义数据模型

首先让人一目了然的是GraphQL查询可以直接映射到返回的数据，它们的结构非常相似。这带来个好处就是你很简单就从查询预测到即将返回的数据，相反的知道需要的数据也可以很简单写出相应的查询语句。更重要的是，这使得GraphQL更加容易学习和应用。

// 下面是一个简单的GraphQL查询，获取id为1001的用户的名字和头像{  user (id: 1001){    name,    photo  }}

// 对应的结果{    "user": {        "name": "shiji",        "photo": "https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=2639867671,3554518423&fm=58"    }}

3.2 分层的

GraphQL另外一个重要的方面就是它自然而成的分层结构。GraphQL很自然的以对象和属性来表示数据之间的关系，这也是GraphQL的命名由来。你可以简单的把GraphQL查询看成三部分。

由{}包裹的对象

对象由属性列表组成

()包裹的查询条件

// 获取用户信息的同时获取该位用户的朋友信息列表，包括姓名、性别和地址信息{  user (id: 1001){ // 第一层    name,    photo,    age,    friends {  // 第二层        name,        sex,        addr {  // 第三层            country,            city        }    }  }}

3.3 强类型

每一级GraphQL查询都关联着一个特殊的类型，而每一种类型都描述了一组可用的字段集合。 GraphQL服务通过定义类型和属性来创建，然后为在这些类型上的每个属性创建函数。跟SQL类似，这使得GraphQL在执行查询之前可以提供描述性的错误信息。

// 对应上一个GraphQL查询，GraphQL 服务需要建立以下自定义类型type Query {    user: User}type User {    name: String,    photo: String,    age: Integer,    addr: Address,    friends: [User]}type Address {    country: String,    city: String}

GraphQL 的类型系统分为标量类型（Scalar Types，标量类型）和其他高级数据类型，标量类型即可以表示最细粒度的数据类型，可以和的原始类型对应。

GraphQL 规范目前规定支持的标量类型有：

Int : 整数，对应JavaScript的Number

Float：浮点数，对应JavaScript的Number

String：字符串，对应Javascript的String

Boolean：布尔值，对应JavaScript的Boolean

ID：序列化后唯一的字符串，对应JavaScript的Symbol

高级数据类型包括：Object、Interface、Union、Enum、Input Object、List、Non-Null 这里不做详述，请参考官方指引。

3.4 协议而非存储

GraphQL并不直接提供后端存储的能力，它不绑定任何的或者存储引擎，它可以利用你已有的代码和技术来进行数据源管理。当然这对改造现有的业务会带来相应的成本。

也就是说GraphQL提供给你了组织与管理数据源的能力，但是数据具体是存在文件系统还是数据库它并不关注。

3.5 自检性

一个GraphQL服务可以直接查询出它所支持的类型，也就是说你不需要花时间写API文档，也不需要花时间理解API。GraphQL直接帮助开发者快速学习和探索API。

// GraphQL查询{    __schema {        queryType {            name,            fields {                name            }        }    }}

// 查询结果{    "data": {        "__schema": {            "queryType": {                "name": "User",                "fields": [{                    "name": "name"                },{                    "name": "photo"                },{                    "name": "age"                },{                    "name": "addr"                },{                    "name": "friends"                }]            }        }    }}

每个 GraphQL 根域都会自动加上一个 __schema 域，这个域有一个子域叫 queryType。我们可以通过查询这些域来了解 GraphQL 服务器支持那些查询

3.6 无需版本的

返回数据的模型完全由客户端的查询决定，所以服务端变得更简单、更容易一般化。

当你添加新的产品功能时，额外的字段可以被添加到服务中，同时并不会影响到现有的业务；当你淘汰老功能的时候，遗弃对应的服务字段依旧可以继续工作。这种渐进式、向后兼容的过程去除了递增版本号的需要。在Fackbook中使用相同版本的GraphQL API 支持了跨域三年的Fackbook应用。

4. GraphQL vs RESTful

之前谈过Fackbook不使用RESTful自研发GraphQL的原因，这里再详细讲一下。

RESTful API的问题在于：

1、缺乏可拓展性。一个刚开始简单的用户接口可能只返回少部分信息，例如用户名、头像等。随着API的不断发展，可能需要返回更多的信息，例如年龄、昵称、签名等。很多时候客户端只是需要其中的部分信息，但是接口依旧传输了所有的信息，这个情况增加了网络传输量，特别对于移动应用来说特别不友好，同时需要客户端自行提取需要的数据。而建立两个功能大致相同只是返回字段有所区别的API则增加了后端实现的复杂度，或者是需要增加业务逻辑判断，或者是增加了维护的难度。

2、复杂的数据需求需要做多次API调用。例如客户端要显示文章的内容，可能要调用文章接口、评论接口、用户信息接口。为构成对一个资源的完整视图，需要做多次单独调用，这样的数据获取方式非常不灵活。

而GraphQL给客户端带来了自主选择的权利。

RESTful：服务端决定有哪些数据获取方式，客户端只能挑选使用，如果数据过于冗余也只能默默接收再对数据进行处理；而数据不能满足需求则需要请求更多的接口。

GraphQL：给客户端自主选择数据内容的能力，客户端完全自主决定获取信息的内容，服务端负责精确的返回目标数据。

举个例子：我们要获取指定id的文章相关信息，包括标题、作者、发布时间以及前两条评论；同时加载当前用户信息。

RESTful:

// 两趟查询，难以拓展GET /user/111GET /article/1001?comment=2

GraphQL：

// 一趟查询，易于扩展{  article (id: 1001){    title,    author,    time,    comments (first: 2)      nickname,      time,      content    }  },  user (id: 111){    nickname,    photo,    sign  }}

获取的数据结果如下所示，就是这么简单粗暴的完成了API定制。

我们不仅按照我们的需求完成数据过滤，同时仅仅使用一次请求就获取了所有你想要的数据。

{    "article": {        "title": "新一代API查询语言GraphQL",        "author": "shiji",        "time": 1481127981218,        "comments": [{            "nickname": "狗剩子",            "time": 1481127981218,            "content": "楼主写的真好"        }, {            "nickname": "不明真相的吃瓜群众",            "time": 1481127981218,            "content": "这瓜真好吃"        }]    },    "user": {        "nickname": "shiji",        "photo": "https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=2639867671,3554518423&fm=58",        "sign": "我的地盘我做主——动感地带"    }}

当然GraphQL给服务器端代码带来了不公平的额外复杂度和管理，GraphQL非常适合于客户对底层数据具有复杂规模的需求，客户端完全可以自主定制个性化API。