首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

GraphQL 的入门指南

类型(Type) 类型是 GraphQL 最重要的特性之一。类型是表示 API 外观的自定义对象。例如,如果你正在构建一个社交媒体应用程序,那么你的 API 应该具有诸如文章、用户、赞、组等类型。...感叹号表示字段不可为空,这意味着每个字段必须在每个查询中返回一些数据。 User 中唯一可以为空的字段是 age。...query (查询) 为了简单地解释这一点,GraphQL 中的查询是获取数据的方式。关于 GraphQL 中的查询,最吸引人的地方之一就是你将获得所需的确切数据,不多不少。...当服务器中发生更新时,服务器将运行订阅中指定的 GraphQL 查询,并向客户机发送一个新更新的结果。 在这篇文章中,我们不打算讨论订阅,但是如果你想阅读更多关于订阅的信息,请单击这里。...你的点赞是我持续分享好东西的动力,欢迎点赞! 一个笨笨的码农,我的世界只能终身学习!

2K30
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    为什么我使用 GraphQL 而放弃 REST API?

    虽然我们很幸运,不必再关心 SOAP,但 REST 也不是历史的终结。 最近,我有机会为自己的项目和客户开发和运行一些使用 GraphQL API 构建的移动和 Web 应用程序。...能指定从服务器请求的对象字段让客户端可以根据需要只获取需要的数据。不再有多个重量级的查询发送到一个刚性的 REST API,为了让客户端可以在应用程序 UI 中一次性显示它。...在大多数情况下,向 GraphQL API 发出的每个请求要么是没有副作用的Query实例,要么是会修改存储在服务器上的对象的Mutation实例。...客户端库根据模式自动解析和验证查询,然后将其发送到 GraphQL 服务器。...除了一些客户端库中存在的一些小问题(现在已经解决了)之外,我强烈推荐你仔细看看 GraphQL 在你的技术栈中可以提供什么。它已经出技术预览四年多了,而且这个生态系统正在变得更加强大。

    2.3K30

    GraphQL:现代API设计的革新

    本文将从GraphQL的基本概念、核心特性、实际使用以及优缺点等方面进行详细介绍。一、GraphQL的基本概念GraphQL是一种用于API的查询语言和运行时,用来满足客户端对数据的精确需求。...通过GraphQL,客户端可以明确指定需要的数据结构,服务器则根据请求返回对应的数据。GraphQL的核心思想是客户端通过单一端点发送查询,服务器返回客户端所请求的数据。...1.2 类型(Type)GraphQL使用强类型系统,每个类型都明确定义了其包含的字段及其类型。常见的类型包括标量类型(如Int、String等)和对象类型(如自定义的用户类型)。...此外,GraphQL还支持列表类型和非空类型。1.3 查询(Query)查询是GraphQL的核心操作,客户端通过查询向服务器请求数据。...我正在参与2024腾讯技术创作特训营最新征文,快来和我瓜分大奖!

    20410

    GraphQL 基础实践

    而 GraphQL 就是为了解决这些问题而来的,向服务端发送一次描述信息,告知客户端所需的所有数据,数据的控制甚至可以精细到字段,达到一次请求获取所有所需数据的目的。...先看右边的 Schema:type 是 GraphQL Schema 中最基本的一个概念,表示一个 GraphQL 对象类型,可以简单地将其理解为 JavaScript 中的一个对象,在 JavaScript...在这里还要注意一点,type Query, Query 类型是 Schema 中所有 query 查询的入口,类似的还有 Mutation 和 Subscription,都作为对应操作的入口点。...两种写法的含义是不同的:前者表示 movies字段始终返回不可为空但Movie元素可以为空。后者表示movies中返回的 Movie 元素不能为空,但 movies字段的返回是可以为空的。...ThinkJS 中配置中间件有三个关键参数: match: 用于匹配 URL,我们想让我们的请求发送到 /graphql 中进行处理,那么我们对这个路径进行 match 后进行处理; handle:中间件的处理函数

    12.8K20

    渗透中遇到GraphQL怎么搞?

    但是graphql很特别,它一般只提供一个接口/graphql,所有的数据查询操作都是向此接口发送请求,并且,只需要发送一次请求就可以获得多个数据 那graphql是怎么实现这一点的呢?...这得归功于graphql的面向对象思想 在graphql中,所有的数据形成了一张彼此相互关联的“图”,此处的“图”是指数据结构中的“图” 怕大家忘了啥是图,贴一张图回忆回忆 ?...它以图为研究对象。图论中的图是由若干给定的点及连接两点的线所构成的图形,这种图形通常用来描述某些事物之间的某种特定关系,用点代表事物,用连接两点的线表示相应两个事物间具有这种关系。...实际上还是借助了面向对象的思想,graphql把每一种数据都给抽象成了一个类,例如咱们上面提到的两个接口,在graphql中,这两个接口背后对应的数据就可以被抽象为Book类以及Author类 但是,这里说的类只是一个概念...book: Book } 其中Book类有一个属性是author,代表一本书的作者,而Author类中有一个属性是book,表示该作者写过的所有的书,这两个类一下子就产生了联系 如果用图论中的有向图表示这两个顶点

    3.4K41

    GraphQL 从入门到实践

    age: Int } 这个 User 对象类型有两个字段,name 字段是一个为 String 的非空标量,age 字段为一个 Int 的可空标量。...,组成一个树形的结构,而用户在向服务端发送请求的时候,沿着这个树选择一个或多个分支就可以获取多组信息。...2.5 请求格式 GraphQL 最常见的是通过 HTTP 来发送请求,那么如何通过 HTTP 来进行 GraphQL 通信呢 举个栗子,如何通过 Get/Post 方式来执行下面的 GraphQL 查询呢...} } Hello world 总是如此愉快,下面我们来进行稍微复杂一点的查询 查询入口 users 查找所有用户列表,返回一个不可空但长度可以为 0 的数组,数组中如果有元素,则必须为 User 类型...;另一个查询入口 user 接受一个字符串,查找 ID 为这个字符串的用户,并返回一个 User 类型的可空字段 # src/schema.graphql # Query 入口 type Query

    2.5K31

    GraphQL是API的未来,但它并非银弹

    这减少了服务器和客户端之间发送的数据量,甚至比 GraphQL 更少,因为你没有发送查询负载,如果响应仍然有效,则服务器发回一个 304 响应(未修改)。...如果是这种情况,GraphQL 的弃用模型对你一点帮助都没有。 使用 REST,你可以创建一个新端点或现有端点的另一个版本。问题是一样的,只是解决方案看起来有一点不同。...但是,GraphQL 模式是如何保证的呢? GraphQL 内省是向服务器发送一个特定的 GraphQL 查询以获取关于 GraphQL 模式的信息。...GraphQL 服务器可以自由地使用它期望的任何类型进行响应。如果你发送一个查询,则服务器的响应可以不符合自省响应中的 GraphQL 模式。以 Apollo Federation 为例。...需要补充的一点是,有很多框架允许你用自己喜欢的编程语言描述模式,比如,通过定义对象或类。然后,你可以获得一个自动生成的接口定义规范,通过一个大家都知道的端点提供出来。

    2K10

    你还在用 REST API 吗?

    作者 | Harsha Vardhan 译者 | 刘雅梦 策划 | 田晓旭 通过 HTTP 发送数据,许多开发人员已经在用 REST 了,而 GraphQL 通常被认为是一种代替遗留 REST API...REST 的核心思想是,通过向资源的 URL 发送请求并获得响应(通常是 JSON,但这取决于 API)来检索资源。...什么是 GraphQL? GraphQL 是一种 API 设计架构,它采用了不同的方法,在这种方法中,所有的东西都被视为一个表示其连接的图。...两者对比的简单示例 例如,我们正在显示用户的供稿,其中包含用户的帖子及其关注者的列表。在我们的例子中,我们必须显示该帖子的作者、帖子以及该用户的关注者。...在 GraphQL 中,我们得到的就是我们所要求的。 对象定义(JSON 响应) 在 REST 中,我们可以在后端定义对象,而在 GraphQL 中,我们则要在前端定义该对象。

    1.5K10

    4种主流的API架构风格对比

    诸如 Google、Facebook(Apache Thrift)和 Twitch(Twirp)这样的大公司如今正在内部使用高性能的 RPC 版本,来执行极高性能、低开销的消息传递。...因此,即便是如今非常好的 REST API 也不一定总是能做到这一点。这就是为什么 HATEOAS 主要是作为 RESTful API 设计的长期开发的愿景而存在。...在系统中,专注于管理对象并面向许多使用者的 API 是最常见的 API 类型。REST 帮助此类 API 具有强大的可发现性,良好的文档编制,因此 REST 非常适合此对象模型。...(如何从 GraphQL 端点仅获取所需要的数据,图源:Mohit Tikoo) 如今,GraphQL 的生态系统正在蓬勃发展,出现了例如 Apollo、GraphiQL 和 GraphQL Explorer...API 向服务端发送一个庞大的查询,该 API 返回一个仅包含我们所需数据的 JSON 响应。

    2.3K30

    GraphQL 和 REST 优缺点对比,附上代码示例

    REST 并不是在 web 上发送信息的第一种协议。但十多年来,它一直主宰着 API 领域。 最近,由 Facebook 设计的新手 GraphQL 变得越来越流行。...主要有三个原因: 到服务器的次数过多 抓取过度/抓取不足 缺乏灵活性 使用 REST Api 访问服务器的次数太多 假设我们正在创建一个社交媒体应用程序。...例如,在 REST 中,您需要向 /api/posts 发送 GET 请求来获取帖子,该请求可能会返回一个 JSON 对象,其中包含帖子标题、内容、标记、日期,可能还有用户 ID。...GraphQL 使得这一点很容易实现。 抓取过度/抓取不足 另一个存在的问题是过多抓取和抓取不足。在 REST API 中,当您到达一个端点时,总是会得到相同的数据,无论您是否需要它。...REST 可能更适合微服务 如果您在后端使用微服务,REST 可能更适合您的目的,因为它是为了将关注点分开。

    1K30

    PayPal大规模采用GraphQL的探索和实践

    如今,PayPal 的多个生产应用程序都在使用 GraphQL。现在,使用 GraphQL 构建新的 UI 应用程序已经成为默认模式。许多现有应用程序正在迁移到 GraphQL。...当我们选择 GraphQL 时,我们正在寻找一种技术来帮助我们解决以下问题: 过度获取的数据:我们的 REST(代表性状态传输)APIs 发送了客户端需要的部分响应和一些无关数据。...我们还没有得到所有前端或后端开发人员的完全认证,但是我们的 REST API 和 GraphQL API 可以共存。我们学会了不操之过急,一点点来。...我们演示了 GraphQL 如何帮助提高内部和外部开发人员的生产力,GraphQL 如何帮助减少交付功能的时间,以及我们如何能够向客户端隐藏复杂性。...GraphQL 正好提供了这一点。向你的团队成员和领导演示使用 GraphQL 构建新功能是多么容易,向现有客户发送更新是多么容易,而不必发布新版本,同时仍然向后兼容。

    3.1K20

    4种主流的API架构风格对比

    缓存 客户端 - 服务器体系结构:允许双方独立发展 应用程序的层级系统 服务端向客户端提供可执行代码的能力 实际上,某些服务仅在某种程度上是 RESTful 的。...因此,即便是如今非常好的 REST API 也不一定总是能做到这一点。这就是为什么 HATEOAS 主要是作为 RESTful API 设计的长期开发的愿景而存在。...在系统中,专注于管理对象并面向许多使用者的 API 是最常见的 API 类型。REST 帮助此类 API 具有强大的可发现性,良好的文档编制,因此 REST 非常适合此对象模型。...如何从 GraphQL 端点仅获取所需要的数据,图源:Mohit Tikoo 如今,GraphQL 的生态系统正在蓬勃发展,出现了例如 Apollo、GraphiQL 和 GraphQL Explorer...API 向服务端发送一个庞大的查询,该 API 返回一个仅包含我们所需数据的 JSON 响应。 ?

    2.3K20

    标准化API设计流程!

    当涉及到API设计时,REST和GraphQL都有自己的优点和缺点。...gRPC将客户端存根编码为二进制格式,并将其发送到低级传输层。 步骤5:gRPC通过HTTP 2在网络上发送数据包。由于二进制编码和网络优化,gRPC据说比JSON快5倍。...1.短轮询 在向PSP发送支付请求之后,支付服务继续询问PSP关于支付状态。经过几轮之后,PSP最终返回状态。 短轮询有两个缺点 续的状态轮询需要来自支付服务的资源。...❝Webhook通常被称为反向API或推送API,因为服务器向客户端发送HTTP请求。使用Webhook时需要注意三点: 我们需要设计一个合适的API供外部服务调用。...打开正在关闭的数据库连接会增加大量开销。所以我们应该通过一个开放连接池连接到数据库。连接池负责管理连接生命周期。 如何设计安全有效的API?

    17110

    C# 一分钟浅谈:GraphQL 数据类型与查询

    例如,可以定义一个表示颜色的枚举类型: enum Color { RED GREEN BLUE } 对象类型 对象类型用于定义复杂的实体。...每个对象类型可以包含多个字段,这些字段可以是标量类型、枚举类型或其他对象类型。例如,定义一个用户对象类型: type User { id: ID! name: String!...Playground或其他工具进行查询: query { getUser(id: 1) { id name email } } 常见问题与易错点 类型不匹配:确保客户端请求的字段类型与服务器端定义的类型一致...空值处理:在定义字段时,使用!表示该字段不能为空。例如,id: ID!表示id字段不能为空。 权限控制:在实际应用中,需要对查询进行权限控制,防止未授权访问敏感数据。...如何避免易错点 严格类型检查:在定义Schema时,尽量使用严格的类型定义,避免使用any类型。 单元测试:编写单元测试,确保查询和突变的正确性。可以使用Hot Chocolate提供的测试工具。

    8500

    C# 一分钟浅谈:GraphQL 数据类型与查询

    例如,可以定义一个表示颜色的枚举类型:enum Color { RED GREEN BLUE}对象类型对象类型用于定义复杂的实体。...每个对象类型可以包含多个字段,这些字段可以是标量类型、枚举类型或其他对象类型。例如,定义一个用户对象类型:type User { id: ID! name: String!...Playground或其他工具进行查询:query { getUser(id: 1) { id name email }}常见问题与易错点类型不匹配:确保客户端请求的字段类型与服务器端定义的类型一致...空值处理:在定义字段时,使用!表示该字段不能为空。例如,id: ID!表示id字段不能为空。权限控制:在实际应用中,需要对查询进行权限控制,防止未授权访问敏感数据。可以使用中间件或自定义指令来实现。...错误处理:GraphQL提供了丰富的错误信息,但在实际开发中,需要合理处理错误,避免暴露过多的内部信息。如何避免易错点严格类型检查:在定义Schema时,尽量使用严格的类型定义,避免使用any类型。

    11510
    领券