即使在 2024 年,GraphQL 仍然存在一些基本问题。 译自 REST Still Outshines GraphQL for Many API Use Cases,作者 Gil Feig。...Douglas Lopes 在 Unsplash 上 在过去的几年里,我一直听到 GraphQL——一种用于 API 的查询语言,允许客户端请求特定数据——是 API 的未来。...随着时间的推移,随着您在请求中增加资源,理解和遵循您的速率限制将变得更加复杂。 最后,随着 API 的成熟,其 GraphQL 模式变得更加复杂。...由于这些响应不像 REST 中那样标准化,因此它们更难计划和自动处理。 许多工程师都有构建和/或维护 REST API 集成的经验。 各种规模的公司主要使用 REST API。...在竞争的 API 架构能够超越——甚至匹配——REST 对提供者和消费者双方的实用性之前,REST 将继续成为首选。
代码示例:产品列表和用户列表的 API 例子 昨天我们学习了 在 Visual Code 中搭建 Laravel 环境,现在我们来学习 Facebook 的 GraphQL 。...GraphQL 是一种 API 查询语言,还是一种根据你为数据定义的类型系统执行查询的服务器端运行时。GraphQL 不依赖于任何指定的数据库或存储引擎,而是由你的代码和数据来作支持的。...https://github.com/graphql/graphiql 从以下图片可以看出,GraphQL 和 Rest 一样都是运行在业务逻辑层以外的: ? 开始 1....添加 GraphQL 的包 使用 composer 安装 graphql-laravel,这个包提供了非常多的功能用于整合 Laravel 和 GraphQL 。 3....创建查询和定义 GraphQL 的类型 GraphQL 中的查询与 Restful API 中的末端路径查询是一样的,查询只是用于获取数据,以及创建、更新、删除操作。
幂等性是 REST API 的一个关键概念,可确保系统的可靠性和一致性。幂等操作可以重复多次,而不会更改初始 API 请求之外的结果。...在 API 中实现幂等性有几个好处: 它可以防止意外的重复操作 它提高了分布式系统的可靠性 它有助于处理网络问题并正常重试 在本周的期刊中,我们将探讨如何在 ASP.NET Core API 中实现幂等性...在 Web API 的上下文中,幂等意味着发出多个相同的请求应具有与发出单个请求相同的效果。换句话说,无论客户端发送同一请求多少次,服务器端效果都应该只发生一次。...并发可能很痛苦,尤其是在高流量 API 中。使用分布式锁的线程安全实现效果很好。当同时收到多个请求时,它可以控制事情。但这应该是罕见的。 对于分布式设置,Redis 是我的首选。...这可以防止滥用幂等密钥并保持 API 的完整性。 在 REST API 中实现幂等性可以提高服务的可靠性和一致性。它确保相同的请求产生相同的结果,防止意外的重复并妥善处理网络问题。
在理想和现实中妥协的 REST API,会让其他的事情也变得困难。...GraphQL API REST 在现实世界里遇到的诸多问题使 GraphQL 应运而生。...REST API 在进化的过程中往往随着 API 版本的变迁,而 GraphQL API 基本没这个必要。...REST API 里是不可能出现的,但在 GraphQL 中是合理的 query,而且不需要你写任何代码,查询器就会忠实地一次次执行你的 resolve 函数,直到把系统内存耗尽或者栈溢出。...如果想要将已有的 API 系统迁移到 GraphQL,初期可以使用 GraphQL 包装已有的 REST API,让客户端工程师尽情试验。
GraphQL mock resolvers (可选) - graphql-tools 基于 GraphQL 的客户端包装 API - graphql-request REST APIs - 使用 Inversify...添加新 comment 时都会检查) 示例 Subscription 执行 VSCode 调试启动配置(添加了预配置的调试启动器) 在开发过程中添加了用于遥测的 Node 仪表板视图 增加了 NodeJS...的一部分,我们可能需要模拟 graphql 响应,直到我们能够实现解析器为止 该基础结构设置为仅为当前未实现的解析器添加模拟。...因此,一旦实现可用,实际的解析器就会接手。同样,如果解析器执行失败,那么这将落在模拟响应上。此功能只能在开发期间使用,因此已添加检查以禁用“生产”版本中的此功能。...为了支持 设置环境变量 GRAPHQL_MOCK 为 true 在 mocks/index.ts 文件定义 mock 解析器(resolver) 作为示例,有查询添加了 examplesMock, peopleMock
GraphQL 对你的 API 中的数据提供了一套易于理解的完整描述,使得客户端能够准确地获得它需要的数据,而且没有任何冗余,也让 API 更容易地随着时间推移而演进,还能用于构建强大的开发者工具。...在schema里,每个数据点都有一个特定的类型,针对这个类型还有验证。 客户端定制查询:GraphQL服务器提供了可以让客户端进行定制查询的能力。...不灵活:随着API的演进,REST需要随时创建新的端点,所以REST API的端点增长速度很快;此外有版本和兼容性需要谨慎考虑。 而GraphQL,典型的结构是只有一个端点。...综上,使用GraphQL的好处是: 避免多重REST请求 向下兼容,无需考虑版本 可以对现有的数据源(例如REST API)进行包装 与开发语言无关 GraphQL查询 我通过Github的GraphQL...但是在windows上多少还是有些问题的,因为Alt+空格也会弹出浏览器的菜单?。。。。
,通过为您的数据提供 GraphQL 或 REST API 以及内置授权来加速 API 开发。...查询转换为实时查询 合并远程架构:通过单个 GraphQL 引擎端点访问自定义业务逻辑的自定义 GraphQL 架构 使用 Actions 扩展功能:编写 REST API 以在 Hasura 模式中添加自定义业务逻辑...适用于有 C++或 Java 背景且具备经验软件工程师 在教室环境中授课,并提供演示视频以及问题与答案交流 可通过 mdbook 构建静态版本并在 web 服务器上查看 trickest/cve[3]...多渠道搜索:使用两种技术手段寻找每个 CVE 对应的 PoCs,一方面根据参考文献中是否存在指向 PoC 网址进行检查;另一方面在 GitHub 上搜索与 CVE ID 相关联且提到了漏洞利用代码库。...包含三个部署 API:Engine (最底层 API)、Pipeline (包装了 Engine 并进行预处理和后处理) 以及 Server (通过 FastAPI 将 Pipelines 封装为 REST
在微服务模式下,意味着有时为了迎合客户端的需求,服务器常会做一些与UI有关的逻辑处理。 2. 加入了BFF 的前后端架构 ?...相比于 REST 风格,GraphQL 具有如下特性: 1. 定义数据模型:按需获取 GraphQL 在服务器实现端,需要定义不同的数据模型。...错误码处理:REST 能够精确返回HTTP错误码,GraphQL 统一返回200,对错误信息进行包装; 5....如果在 REST 中,可能会增加 api/v2/inspections进行 API 升级。但是在 BFF 中,为了向前兼容,我们可以使用图三的结构。...在引入了 BFF 的项目,我们的测试仍然使用金字塔原理,只是在客户端和后台之间,需要添加对 BFF 的测试。
在本指南中,我们将介绍如何将 GraphQL 无缝集成到您的 React.js 项目中。什么是 GraphQL?GraphQL 是用于 API 的查询语言,也是用于执行那些查询的运行时。...它允许您仅请求所需的数据,从而使 API 调用更加高效。与传统的 REST API 不同,传统的 REST API 由服务器确定响应结构,而 GraphQL 则使客户端能够定义其所需数据的形状和结构。...连接到 GraphQL 服务器要在 React.js 项目中使用 GraphQL,您需要连接到 GraphQL 服务器。...在这个例子中,假设您有一个在 http://localhost:4000/graphql 上运行的 GraphQL 服务器。您可以将此 URL 替换为实际的 GraphQL 服务器端点。...: new InMemoryCache(),});export default client;在 React 组件中使用 GraphQL 获取数据现在,让我们使用 GraphQL 在 React 组件中获取数据
在过去一年中,我们构建了一系列的工具来将所有的 REST API 转换为 GraphQL,在我们的后端开发人员继续编写他们熟悉的 API 的同时,让客户端开发人员可以通过 GraphQL 访问所有数据。...我还记得当 Facebook 首次推出 GraphQL 时,我们团队都兴奋不已——我们当即意识到 GraphQL 可以解决我们的很多问题,让我们可以在单次的请求中获取所有数据,并为我们的 API 提供结构化文档...经过一番调研,我们找到了一个很好的方式来帮助我们使用 GraphQL——我们决定在我们的 REST API 之上添加一个 GraphQL 代理层。...在生产环境应用 GraphQL 封装 REST API 的过程很简单——我们构建了一些实用程序来执行下游的 REST 请求,从而在解析器中获取数据,并制定了一些关于如何将现有模型转换为 GraphQL...首先,我们构建了少量的 GraphQL 解析器,然后在生产环境中启动一个 GraphQL 服务器,以调用下游 REST 接口请求我们的资源。
单一入口点:GraphQL通常只有一个入口点(通常是/graphql),客户端可以在单个请求中获取多个资源的数据。...图解 ---- Code Spring Boot + Rest 在Spring Boot中整合REST,您可以使用Spring Web模块,它提供了用于构建RESTful Web服务的支持。...添加依赖,确保在pom.xml文件中包含以下依赖: org.springframework.boot GraphQL 在Spring Boot中整合GraphQL,您可以使用第三方库(例如graphql-java和spring-graphql)。...添加依赖,确保在pom.xml文件中包含以下依赖: com.graphql-java-kickstart <artifactId
你可以将多个调用封装到一个 API 中,让它们在服务器端完成,而不是从客户端发出多个请求。此方法也可以解决过取和欠取问题,因为你可以在将数据发回客户端之前对其进行操作。...如果在你的组织中存在 REST API 版本过多的问题,那么在使用像 GraphQL 这样的新工具解决这个问题之前,也许你应该首先了解一下自己所在的组织,为什么会有这么多版本。...7 支持遗留应用 在这一段中,作者说,为移动应用保留 REST API 的旧版本是一件痛苦的事情。他总结说,因为我们只使用了一个 GraphQL 服务器,所以没有这个问题。...与 REST 相比,GraphQL 生态系统的扩张速度非常快。 在服务器渲染的 Web 应用程序中,Hypermedia API 发挥了并将继续发挥重要的作用。然而,网络在向前发展。...我认为,REST API 是内部 API、合作伙伴 API 和服务器间通信的完美工具。在这方面,与 REST 相比,GraphQL 并没有真正带来任何好处。
它作为 REST 统一界面约束中的一个子约束,是 REST 架构中最重要、最复杂,也是构建成熟 REST 服务的核心 Richardson 成熟度模型是根据 REST 约束对 API 成熟度进行衡量的一种方法...这些 URL 能够告诉客户端如何使用 API,它们由服务器根据应用程序当前的状态动态生成,而客户端在得到响应后,通过这些 URL 就能够知道服务器提供哪些操作,并使用这些链接与服务器进行交互 7.5 GraphQL...,而 GraphQL 能够根据客户端的请求灵活地返回所需要的形式 (4)版本:GraphQL 是在客户端来定义资源的表现形式,因此服务端数据结构变化不影响客户端的使用,即使服务器发生更改,也是向后兼容...GraphQL 仅使用一个端点即可执行并响应所有 Graph 查询请求,因此它完全可以与 Library.API 项目中现有的 REST 端点共存,弥补 RESTful API 的不足 添加nuget...类型、查询以及 Schema 都创建完成后,应将它们添加到依赖注入容器中 添加一个扩展方法,并在扩展方法中添加所有类型 namespace Library.API.Extentions { public
在 GraphQL 架构中,客户端提交查询以获取数据。 典型场景 REST API 假设您有一个 API 来获取学生数据。...在典型的 REST 场景中,请求/响应如下所示: // HTTP REQUEST GET api/students/1 || api/students?...可用性 REST API 使用 URI 和 HTTP 技术,这使得 API 很难预测在联系新端点时会发生什么。REST 中缺少指定的版本控制要求允许提供者采用他们自己的方法。...使用 GraphQL,您可以向您的 API 发送请求并接收准确的响应,而无需进一步添加。因此,来自 GraphQL 查询的极其可预测的响应提供了良好的可用性。...错误处理 每个 GraphQL 请求、成功或错误都会返回 200 状态代码。与 REST API 相比,这是一个明显的区别,在 REST API 中,每个 状态代码都指向某种类型的响应。
服务器和客户端之间的交互机制归结为调用端点并获取响应。 易于添加功能。...构建 SOAP API 服务器需要深入了解所有相关协议及其严格限制的规则。 消息更新繁琐。需要额外添加或删除消息属性,僵化的 SOAP 模式会降低其采用速度。...以动词为中心的 RPC 中的操作与以名词为中心的 REST 中的操作相反 在 REST 中,操作是使用 HTTP 方法完成的,例如 GET、POST、PUT、DELETE、OPTIONS 以及 PATCH...模式构建非常困难,因为它需要模式定义语言 (SDL) 中的强类型支持。 在查询之前掌握了模式后,客户端可以验证其查询,确保服务器能够响应。...GraphQL 中的查询执行 除了 RESTful CRUD 操作之外,GraphQL 还具有允许从服务器获取实时通知的订阅功能。 GraphQL 的优点 类型化架构。
随着针对 REST API 的 Apollo Connectors 的推出,开发人员可以逐步或一次性地将 REST API 集成到 联邦 GraphQL 架构中。...“这也摆脱了额外的网络跳转、性能成本以及与在生产环境中运行服务器相关的一切。”...它不比 REST 好,”DeBergalis 在其 GraphQL 峰会 2024 的主题演讲中说道。“这不是重点。它使这些东西变得更好,对吧?”...更具体地说,正如 Apollo 的 Dylan Anthony 在一篇 博文 中所说,在Connectors 发布之前,开发人员在将 REST 服务添加到联邦 GraphQL API 时必须采取许多额外的步骤...组合和发布用于更新路由器的模式,以便路由器可以直接与 REST API“对话”: Coinbase 的观点 然而,世界不仅仅只有 REST API。
而对API架构的选择引起了无休止的讨论。 ? 现在,很多API用户放弃REST,并拥抱GraphQL。而在十年之前,对于REST来说则是相反的情况,在于SOAP的竞争中,REST大获全胜。...RPC如何工作 客户端唤醒远端程序,序列化参数,并在消息中添加额外的信息,然后将消息发送给服务端。在接收到客户端的消息后,服务端会反序列化消息中的内容,执行请求的操作,并将结果返回给客户端。...GraphQL如何工作 一开始,GraphQL会创建一个schema(模式),它描述了在一个GraphQL API中的所有请求以及这些请求返回的所有types。...详细的错误消息:与SOAP类似,GraphQL提供了详细的错误信息,错误信息包括所有的解析器以及特定的查询错误。 灵活的权限:GraphQL允许在暴露特定的功能的同时保留隐私信息。...而REST架构不能部分展示数据(要么全部显示,要么全部隐藏)。 GraphQL 的缺点 性能问题:GraphQL用复杂度换来功能上的提升。在一个请求中包含太多封装的字段可能会导致系统过载。
可以把GraphQL当做REST的备选项来构建API,而REST是一种概念模型,可以用来设计和实现API。GraphQL是一种标准化的语言、type系统和在客户端和服务器之间建立起强约定的规范定义。...GraphQL vs REST 下面的部分,建议跟着源码走,可以在accompanying GitHub repo找到本文相关源码 源码包含3个项目: RESTful API实现 GraphQL API...版本控制难的一个因素是通常很难知道什么信息在被哪些应用和设备使用 添加信息一般很容易,无论是REST还是GraphQL,添加字段的话,会流入REST客户端,而会被GraphQL安全忽略,除非改变查询。...然而,删除和编辑信息就大有不同了 在REST方式中,很难知道字段级的哪些信息被使用了。我们能知道一个接口/movies被用了,但不知道客户端在用titl,image,还是2个都用了。...说到这里,开发者为REST API的扩展付出了巨大代价。接口数量瞬间爆炸,不一致性越来越明显,版本控制越来越困难 GraphQL在开发体验方面确实有过人之处。
因为 Go 简洁的语法、较高的开发效率和 goroutine,有一段时间也在 Web 开发上颇为流行。由于工作的关系,我最近也在用 Go 开发 API 服务。...但对于 Golang 这种奉行极简主义的语言,如何提高代码复用率就会成为一个很大的挑战,API server 中的大量接口很可能有完全一致的逻辑,如果不解决这个问题,代码会变得非常冗余和难看。...Python 中的装饰器 在 Python 中,装饰器功能非常好的解决了这个问题,下面的伪代码中展示了一个例子,检查 token 的逻辑放在了装饰器函数 check_token 里,在接口函数上加一个...以下的 API 服务代码示例是基于 Gin-Gonic 框架,对 Gin 不太熟悉的朋友,可以参考我之前翻译的一篇文章:如何使用 Gin 和 Gorm 搭建一个简单的 API 服务器 (一) 本文中的代码为了方便展示... 接口可能会有要求客户端必须传某些特定的参数或者消息头,而且很可能每个接口的必传参数都不一样,这就要求装饰器函数可以接收参数,不过我目前还没有找到在 pipeline 的方式下传参的方法,只能使用最基本的方式
你是否在犹豫是否要在 .NET 应用中从 REST 转向 GraphQL。我在两种技术领域都有多年经验,在此分享所有心得体会——包括优点、缺点和挑战。...基础理解 GraphQL 是一种 API 查询语言,允许客户端按需获取数据。与 REST(服务器决定每个端点返回的数据)不同,GraphQL 让客户端精确指定所需数据。...将每个字段匹配到对应的解析器(Resolver) 3. 尽可能并行执行解析器 4. 将结果组装成请求的精确结构 解析器是 GraphQL 执行的核心。它们是负责获取模式中每个字段数据的函数。...这与 REST 有本质区别——在 REST 中,每个端点通常映射到单个控制器操作;而在 GraphQL 中,可能需要数十个解析器协同工作以满足单个查询。...在 .NET 中设置 GraphQL(逐步指南) 0️⃣ 生态 HotChocolate 是 .NET 中最流行的 GraphQL 服务器,优势包括: • 专为 .NET 构建 • 高性能 • 丰富功能集