GraphQl

什么是GraphQl

打开https://graphql.org 官网首先看到下图

image.png

A query language for your API

GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.
GraphQL 是一种 API 查询语言，也是一种使用现有数据完成这些查询的运行时。 GraphQL 为您的 API 中的数据提供了完整且易于理解的描述，使客户能够准确地询问他们需要什么，仅此而已，使 API 更容易随着时间的推移而发展，并支持强大的开发人员工具。它虽然跟SQL一样有着QL的后缀，也能绑定NoSQL类型的数据库和关系型的数据库，但是GraphQL与SQL并没有必然联系。

---

使用场景

在app或网站首页往往存在大量的接口数据请求来渲染页面或组件，数据结构也各不相同，如个人信息、列表1、列表2、导航1、导航2、轮播图等等。造成的结果可能就是一个异常庞大的树形结构数据，有些接口甚至是交叉或者冗余的。如何解决？创造一个完整且完美的API来满足？那如果新的需求有变动呢？那这个完美的API也要调整，这显然不是一个好办法。此时GraphQl就派上用场了，灵活的自由组合就可以编排一个近似完整API。

特点

• 你想要什么，就得到什么
  向您的 API 发送 GraphQL 查询并准确获取您需要的内容，不多也不少。 GraphQL 查询总是返回可预测的结果。 使用 GraphQL 的应用程序快速且稳定，因为它们控制的是获取的数据，而不是服务器真正的数据。
• 一个请求，获取多个结果
  GraphQL 查询不仅可以访问一种资源的属性，还可以平滑地跟踪它们之间的引用。 虽然典型的 REST API 需要从多个 URL 加载，但 GraphQL API 在单个请求中获取您的应用所需的所有数据。 即使在缓慢的移动网络连接上，使用 GraphQL 的应用程序也可以快速运行。
• 描述所有的可能类型系统
  GraphQL API 基于类型和字段的方式进行组织，而非入口端点。你可以通过一个单一入口端点得到你所有的数据能力。GraphQL 使用类型来保证应用只请求可能的数据，还提供了清晰的辅助性错误信息。应用可以使用类型，而避免编写手动解析代码。

问题

通过上面的描述，可能会有一种错觉，感觉GraphQL很完美，但其实不然，它也存在不适用的情况

• 单一的API请求
  对于复杂性不强，小的修改就足以满足应用的场景，例如注册、短信验证码登录、小表单等。这些事情都是围绕着一个用户的具体某项或多项信息发生的，根本没有任何图的概念。如果强行引入GraphQL反而会变的复杂。
• 使用误区
  不要将 GraphQL 误认为是服务器端数据库的替代品。 它只是一种简单的查询语言。 当请求查询时，服务器执行数据库访问或者从缓存中检索。 当我们必须在一个查询中访问多个字段时，无论是在 RESTful 架构还是 GraphQL 中请求，仍然需要从数据源中检索各种资源和字段。 因此，当客户端一次请求太多嵌套字段数据时，它也会显示相同的问题。 因此必须有一种机制，如最大查询深度、查询复杂度加权、避免递归或持久查询，以阻止来自客户端的低效请求。

graphql中国 https://graphql.cn/
graphql官网 https://graphql.org