前三个问题可以通过另外编写一个 REST API 来解决。将新编写的 API 作为外观,用于特定的用户界面。以 Next.JS 为例。Next 提供了非常轻量级的语法定义 API。...4 强类型接口 在这一段中,Kyle 指出了 REST API 类型不严格的问题。他谈到了 API 的问题,即你不清楚获得的是一组帖子,还是其他的什么东西,以及查询参数如何使情况变得更加复杂。...你可能会认为,OAS 不能保证 API 的响应符合规范。你说的对。但是,GraphQL 模式是如何保证的呢?...需要有人坐下来,编写如何使用 API 的示例查询和用例。否则,真的很难上手。 因此,尽管社区一直在说,“GraphQL 是自记录的”,但这个特性本身并不能成为一个有用的 API。...8 错误处理更好 关于错误处理,作者描述了这样一个场景:与使用部分数据响应的单个 GraphQL 查询相比,客户端将不得不进行 3 次连续的 REST API 调用。
该模式大致表示了 GraphQL 层可以响应的范围。 还不够清楚?我们可以说 GraphQL 其实根本就是:REST API 的接替者。所以让我回答一下你最有可能问的问题。...例如,READ REST API 端点可能是 GET /ResouceName - 从该资源获取所有记录的列表; GET /ResourceName/ResourceID - 获取该 ID 标识的单条记录...上面提到的 REST API 的问题正是 GraphQL 试图要解决的问题。它们当然不是 REST API 的所有问题,我也不想讨论 REST API 是什么。...如果我们有一个 GraphQL 查询,我们明确知道如何在 UI 中使用它的响应,因为查询与响应具有相同的“结构”。我们不需要检查响应才知道如何使用它,我们也不需要有关 API 的任何文档。...操作和读取缓存需要遍历查询。尽管我们需要编写一个中间层来处理这些缓存逻辑,但是这种方式总体上比基于响应的缓存更有效率。Relay.js 便是一个采用这种缓存策略并在内部实现自动管理的框架。
GraphQL 通过强制客户端准确指定他们需要哪些字段来解决 API 版本控制和维护问题。API 开发人员可以主动联系已知的字段使用者,以迁移已弃用的字段。响应包括有关哪些字段已弃用的信息。...这减少了应用程序中的响应大小和处理。但是,它没有提供一种机制来指示字段已被弃用。 OData 更加灵活,因为可以轻松编写查询以返回所有字段。OData 正在将模式版本控制添加到规范中以解决此问题。...例子 为了直观地说明使用这些 API 的差异,以下两个代码示例展示了如何在 GraphQL 和 OData 中执行“排序依据”。...对于习惯于处理 Web 服务的人来说,GraphQL 也可能有点尴尬,因为为了查询数据,您不需要执行 GET 操作,这就是您从普通 REST Web 服务获取结果的方式。...您执行 POST,准确定义要包含在响应中的字段和函数。 因此,尽管 GraphQL 使您能够从元数据中确定哪些字段和函数可用,但您仍然不知道它们在语义上的含义。
简单来说,这意味着 REST API 的每次响应都会提供链接到所有相关信息的元数据,这些信息与如何使用该 API 有关。这实现了客户端和服务器的解耦。...四、GraphQL 仅查询所需数据 它需要多次调用 REST API 才能返回所需的人员信息。因此,GraphQL 的发明就是为了改变现状。 GraphQL是一种描述如何发出精确数据请求的语法。...如何从 GraphQL 端点仅检索所需数据 如今,GraphQL 生态系统正在通过 Apollo、GraphiQL 和 GraphQL Explorer 等库和强大的工具不断扩展。...在查询之前掌握了模式后,客户端可以验证其查询,确保服务器能够响应。到达后端应用程序后,GraphQL 操作将根据整个模式进行解释,并解析为前端应用程序的数据。...GraphQL 中的查询执行 除了 RESTful CRUD 操作之外,GraphQL 还具有允许从服务器获取实时通知的订阅功能。 GraphQL 的优点 类型化架构。
客户端通过编写GraphQL查询语句,告诉服务器需要哪些数据,服务器根据查询语句返回精确的数据。...这种方式的优点是减少了不必要的HTTP请求,降低了网络带宽消耗;缺点是需要学习和掌握GraphQL查询语句的编写,GraphQL比较年轻,相对于我们使用REST风格的方式,例如HTTP方法(GET、POST...GraphQL与REST的差异点REST API 是应用程序通信的架构概念。与之相对的 GraphQL 则是一种规范、一种 API 查询语言和一组工具。...差异性对比项GraphQL API风格REST API风格定义GraphQL 是一种查询语言、架构样式以及一组用于创建和操作 API 的工具。...所以如何选择API架构风格,则一目了然。总结本文主要了解下什么是GraphQL,从数据获取方式、通信性能、灵活性以及使用场景上,浅谈下GraphQL,希望能给更多开发者以帮助。
基本来说,这意味着 REST API 在每个响应中都提供元数据,该元数据链接了有关如何使用该 API 的所有相关信息。这样便可以使客户端和服务端解耦。...如何从 GraphQL 端点仅获取所需要的数据,图源:Mohit Tikoo 如今,GraphQL 的生态系统正在蓬勃发展,出现了例如 Apollo、GraphiQL 和 GraphQL Explorer...GraphQL 的工作机制 GraphQL 从构建模式(Schema)开始。模式是对于用户可以在 GraphQL API 中进行的所有查询及其返回的所有类型的描述。...因为在客户端进行查询之前已经定义好了模式,所以客户端可以验证其查询语句,以确保服务端能够对查询语句进行响应。...API 向服务端发送一个庞大的查询,该 API 返回一个仅包含我们所需数据的 JSON 响应。 ?
基本来说,这意味着 REST API 在每个响应中都提供元数据,该元数据链接了有关如何使用该 API 的所有相关信息。这样便可以使客户端和服务端解耦。...(如何从 GraphQL 端点仅获取所需要的数据,图源:Mohit Tikoo) 如今,GraphQL 的生态系统正在蓬勃发展,出现了例如 Apollo、GraphiQL 和 GraphQL Explorer...1 GraphQL 的工作机制 GraphQL 从构建模式(Schema)开始。模式是对于用户可以在 GraphQL API 中进行的所有查询及其返回的所有类型的描述。...因为在客户端进行查询之前已经定义好了模式,所以客户端可以验证其查询语句,以确保服务端能够对查询语句进行响应。...API 向服务端发送一个庞大的查询,该 API 返回一个仅包含我们所需数据的 JSON 响应。
让我们研究一下GraphQL的设计原则。 查询是分层结构的,具有分层和嵌套字段,查询与响应数据一对一匹配。查询和响应的形状像树,可以查询每个项目的其他嵌套字段。...像RESTful API一样,GraphQL API旨在处理HTTP请求并提供对这些请求的响应。但是,相似之处到此结束。...在REST API建立在请求方法和端点之间的连接上的情况下,GraphQL API设计为仅使用一个始终通过POST请求查询的端点,通常使用URL yourdomain.com/graphql。...GraphQL提供的性能优于REST API,可以为前端开发人员带来回报。使用GraphQL规范创建服务器可能需要更多设置和编写预测性服务器端逻辑来解析和处理请求。...很难缓存,缓存API响应的目的主要是为了更快地从将来的请求中获取响应。与GraphQL不同,RESTful API可以利用HTTP规范中内置的缓存。
在本文中,我们将探讨如何使用 GraphQL 和 Ballerina 将 MySQL 数据库中的数据作为 API 公开出来。...GraphQL 既可以被视为一种 API 查询语言,也可以被视为一种服务器端运行时,用于执行由用户定义的查询。...GraphQL 是更好的 REST 在过去的十年中,REST 已经成为一种流行的 API 设计架构。...这个示例演示了如何使用 Ballerina 实现 GraphQL 服务器,将 MySQL 数据库中的数据以及通过另一个 API 调用获取的数据公开出来。...在创建所需的记录之前,需要分析一下根据指定 ISBN 从 Google Books API 获取的的 JSON 响应消息的格式。它返回一个 JSON 对象,其中包含了一个“items”的数组。
基本来说,这意味着 REST API 在每个响应中都提供元数据,该元数据链接了有关如何使用该 API 的所有相关信息。这样便可以使客户端和服务端解耦。...如何从 GraphQL 端点仅获取所需要的数据,图源:Mohit Tikoo 如今,GraphQL 的生态系统正在蓬勃发展,出现了例如 Apollo、GraphiQL 和 GraphQL Explorer...GraphQL 的工作机制 GraphQL 从构建模式(Schema)开始。模式是对于用户可以在 GraphQL API 中进行的所有查询及其返回的所有类型的描述。...因为在客户端进行查询之前已经定义好了模式,所以客户端可以验证其查询语句,以确保服务端能够对查询语句进行响应。...API 向服务端发送一个庞大的查询,该 API 返回一个仅包含我们所需数据的 JSON 响应。
但关键部分使用的是超媒体(又称HATEOAS,Hypertext As The Engine of Application State),意味着对于每个响应,REST API提供了如何使用API的所有元数据信息...如何对资源进行建模,以及对哪些资源建模取决于具体场景,这使得REST在理论上是简单的,但实践上是困难的。 载荷较大:REST会返回大量元数据,因此客户端可以从响应的信息中了解到应用的状态。...简单资源驱动的APPs:REST是一种非常有用的方法,可用于连接不需要灵活查询的资源驱动型应用。 GraphQL:仅请求需要的数据 它需要多次调用REST API才能返回所需的内容。...在给服务端发送包含大量查询的请求之后,API会返回一个JSON响应,内容正对应请求的资源。 ? 除RESTful CRUD操作外,GraphQL还有订阅功能,允许接收服务端的实时通知。...因此,即时对于复杂的查询,REST仍然是一个比较好的选择。 缓存复杂:GraphQL 没有使用HTTP缓存语义,需要客户自定义。
在过去一年中,我们构建了一系列的工具来将所有的 REST API 转换为 GraphQL,在我们的后端开发人员继续编写他们熟悉的 API 的同时,让客户端开发人员可以通过 GraphQL 访问所有数据。...在生产环境应用 GraphQL 封装 REST API 的过程很简单——我们构建了一些实用程序来执行下游的 REST 请求,从而在解析器中获取数据,并制定了一些关于如何将现有模型转换为 GraphQL...这样并没有将我们的资源真正地链接在一起,我们仍然会使用尽可能多的 GraphQL 查询来获取数据,就像使用 REST API 一样。...得益于 GraphQL 额外提供的类型安全检查,开发人员更容易检测数据和编写查询,我们的站点更加可靠,并且使用 GraphQL 加载数据的页面运行得更快。...尽管我们的前端开发人员不得不学习如何使用 GraphQL,但我们不需要重写任何后端 API 或运行复杂的迁移流程才能使用 GraphQL——开发人员创建新的项目可以直接使用。
至此,我再也无法回过头来享受使用 REST 的工作了。 REST 有什么问题吗? 每个 REST API 都是独特的 公平地说,REST 甚至不是一个标准。...如果开发团队不是全栈的,那么服务器和客户端团队之间的沟通就至关重要,在没有机器可读的 API 规范的情况下更是如此。 GraphQL 如何做得更好?...要了解这些工具是如何工作的,请查看 Star Wars API 示例,它可以作为 GraphiQL 的在线演示。 能指定从服务器请求的对象字段让客户端可以根据需要只获取需要的数据。...如果使用一些现成的 GraphQL->数据库查询翻译库,你甚至不需要在服务器上编写大多数数据库查询。...客户端库可以很容易地将 GraphQL 响应自动解包为所需类型的对象实例,因为从模式和查询可以提前知道响应形状。 GraphQL 是个时髦的东西,是一种时尚,对吗?
作者 | Brian Rinaldi 译者 | 王强 策划 | 李俊辰 除了 REST 以外,很多 API 都开始支持 GraphQL,甚至完全支持它了。...在这篇教程中,我想采用一种不一样的方法,并向你展示从 Node 和客户端 JavaScript(不带库)调用 GraphQL API 实际上有多么容易。...由于 GraphQL 是通过单个端点运行的,因此端点响应的数据完全取决于你的查询。这个查询需要正确格式化 GraphQL。想知道如何构建查询吗?请查阅关于如何编写 GraphQL 查询的教程。...不过在 API 完全开放的情况下,我们先来看一下它是如何完成的(请注意,我的示例确实有一个 API 密钥,但请按照我说的那样做,不要像在演示中那样对付一下……)。...显然,一般来说你不会想要简单地向用户显示查询结果,因此让我们看一下如何使用返回的数据。 使用 GraphQL 查询响应 GraphQL 的一大优点是,它的响应只是纯 JSON,因此数据使用起来很容易。
GraphQL在标准REST API技术上获得发展的原因。...使用传统的RESTAPI端点,客户端应用程序可以查询服务器资源,并接收包含与请求匹配的所有数据的响应。...如果来自RESTAPI端点的成功响应返回35个字段,则客户端应用程序将接收35个字段 提取问题 传统上,REST API无法为客户端应用程序提供唯一的方法来仅检索或更新他们关心的数据。...REST的响应 REST API设计人员不愿无休止地失败,他们尝试通过以下几种方式来解决移动应用程序性能问题: “include”和“exclude”查询参数,允许客户端应用程序通过潜在的长查询格式指定他们想要的字段...在许多方面,这又回到了早期的web编程模式,客户端应用程序代码将直接查询后端系统——例如,有些人可能记得10-15年前在jsp上使用JSTL编写SQL查询!
通常,与 REST 相比,GraphQL 被认为是一种革命性的 Web API 设计方式。但是,如果您仔细研究该技术,您会发现它们之间存在很多差异。...GraphQL 会在未来超过 REST 吗?让我们来看看如何使用 Spring Boot 和 Apollo 客户端创建通过 GraphQL API 进行通信的微服务。...我们还应该启用 GraphiQL——一个用于编写、验证和测试 GraphQL 查询的浏览器内 IDE,以及 GraphQL Java 工具库,它包含用于创建查询和突变的有用组件。...基于这一点,Spring 将能够自动检测并调用正确的方法,作为对模式内声明的 GraphQL 查询之一的响应。这是一个包含查询实现的类。...结论 GraphQL 似乎是标准 REST API 的有趣替代品。但是,我们不应将其视为 REST 的替代品。在某些用例中,GraphQL 可能是更好的选择,而在某些用例中,REST 是更好的选择。
GraphQL 的查询语言没有包含其他标准,如 HTTP 或 REST。它对客户端和服务器如何通信请求和结果是不可知的。...商业 GraphQL JDBC 驱动程序支持基于 SQL 查询的请求。 OpenAPI OpenAPI 以JSON Schema为基础,并依赖于 HTTP REST。...重用:通过定义概念(如数据产品、查询片段或关系)来强调可重用的构建块,为灵活的组合奠定基础。 定制:通过组合组件来实现所需的结果,为特定用例或逻辑操作定制数据响应。...由于其专业化重点,GraphQL 可以提供以多种语言实现的参考库。这些库解析 GraphQL 模式和查询并将它们连接到代码,从而促进数据库和业务逻辑集成到响应中。...手动编写 GraphQL 解析器不在我的愿望清单上;让这项任务可行的是自动化的 GraphQL。有一些可信赖的供应商拥有出色的 GraphQL 自动化功能,这使得此方法变得可行且有吸引力。
在本系列教程中,我们将研究 GraphQL,了解它是什么,并学习使这种查询语言如此直观和易用的原因是什么。 先让我们研究一下 REST 存在的问题,以及 GraphQL 如何解决它们。...REST 很久以前,当我们把 API 的设计从 SOAP 转向 REST 时,认为此举将会为工作提供更多的灵活性。我们不能否认 REST 的运作是良好的,在当时是一个很好的举措。...这些在 GraphQL 中并不需要,因为你可以通过添加或删除类型来改进 API。 在GraphQL中,你所需要做的就是写新代码。可以编写新类型、查询和修改,而无需维护其他版本的API。...GraphQL 是一种查询语言,这意味着你可以使用任何自己熟悉的语言。在编写本教程时,GraphQL 支持的语言已经超过了 12 种。...结论 GraphQL 的确是API的未来,我们需要了解更多信息。这就是我决定撰写这一系列教程的原因,这些教程将为我们展示如何用好 GraphQL,先从查询和修改开始,然后是订阅和身份验证。
GraphQL API GraphQL 是一种用于 API 的查询语言,也是使用现有数据完成这些查询的运行时。...GraphQL 与 REST: GraphQL 和 REST API 之间的主要区别在于 GraphQL 是一种查询语言,而 REST 是一种基于网络的软件的架构概念。...在 GraphQL 架构中,客户端提交查询以获取数据。 典型场景 REST API 假设您有一个 API 来获取学生数据。...使用 GraphQL,您可以向您的 API 发送请求并接收准确的响应,而无需进一步添加。因此,来自 GraphQL 查询的极其可预测的响应提供了良好的可用性。...GraphQL 通过单个端点提供,通常是 (/graphql),并且与 HTTP 规范不同。因此,无法像 REST API 那样缓存查询。 但是,由于可用的工具,客户端缓存优于 REST。
它作为 REST 统一界面约束中的一个子约束,是 REST 架构中最重要、最复杂,也是构建成熟 REST 服务的核心 Richardson 成熟度模型是根据 REST 约束对 API 成熟度进行衡量的一种方法...根据上述3个因素,RESTful API 应用的成熟度分为3级: 第 1 级:资源 第 2 级:HTTP 动词 第 3 级:超文本驱动,即 HATEOAS HATEOAS 使 API 在其响应消息中不仅提供资源...这些 URL 能够告诉客户端如何使用 API,它们由服务器根据应用程序当前的状态动态生成,而客户端在得到响应后,通过这些 URL 就能够知道服务器提供哪些操作,并使用这些链接与服务器进行交互 7.5 GraphQL...全称 Graph Query Language,作为查询语言,最主要的特点是能够根据客户端准确地获得它所需要的数据 作为 API 查询语言,GraphQL 提供了一种以声明的方式从服务器上获取数据的方法...GraphQL 仅使用一个端点即可执行并响应所有 Graph 查询请求,因此它完全可以与 Library.API 项目中现有的 REST 端点共存,弥补 RESTful API 的不足 添加nuget