今日视点:GraphQL全解析,你学会了吗?
您可能已经看过很多关于GraphQL的内容,在这个过程中是不是有时会感到困惑和不知所措。本文让我尝试用更简单易懂的语言回答关于GraphQL的三个主要问题:GraphQL是什么,如何工作,何时使用?希望对您更好地理解GraphQL有所裨益。
1 什么是GraphQL“Graph”指的是数据以类似图形的结构表示和连接。在GraphQL中,数据表示为具有节点和边的图形,允许不同数据实体之间的灵活关系。
“QL”代表“查询语言”,因为GraphQL提供了一种精确和可控的查询或请求数据的语言。
(资料图)
示例:书和作者的关系可以用图来表示,可以很容易地使用GraphQL进行查询:
深入研究GraphQL,我们发现它是:
类型系统:定义数据的外观以及事物之间的关系。类型系统定义各种数据类型和架构,这是客户端和服务器之间的合同。查询语言:查询数据的语言,它知道从哪里获取数据并包含验证或执行查询的规则。简而言之,GraphQL能让客户端精确指定它需要从API获取的数据。
Facebook在2012年开始开发GraphQL,并于2015年将其发布为开源。2018年,GraphQL被移至新成立的GraphQL基金会,由非营利组织Linux基金会托管。
GraphQL支持读取、写入(变异)和订阅数据的更改,让我们可以实时更新。
2 GraphQL如何工作GraphQL有两个部分:请求数据的客户端和提供数据的服务器,以下是解释其工作原理的步骤:
i)定义模式:服务器定义GraphQL模式,这类似于描述可用数据和操作的蓝图。例如,如果我们有一个带有字段(id、name和pageCount)的Book实体,并且有一个查询是按id查询书籍,则其模式将如下所示:
type Query { bookById(id: ID): Book}type Book { id: ID name: String pageCount: Int}
ii)发送查询:客户端向服务器发送GraphQL查询,指定所需数据和所需结构。
query bookDetails { bookById(id: "book-1") { id name pageCount }}
iii)解决查询:服务器的GraphQL引擎接收查询并开始解决查询。它根据查询确定需要哪些数据,以及应执行哪些解析器函数来获取该数据。
iv)获取数据:解析器函数根据查询要求从各种数据源(例如数据库、API)检索数据。
v)组装响应:GraphQL引擎收集检索到的数据,并按客户端请求的格式组装响应。它仅包括查询中请求的确切数据字段,减少不必要的数据传输。
vi)返回响应:服务器将响应发送回客户端,提供查询中精确请求的数据。
3 何时可以使用GraphQLGraphQL适用于处理复杂或经常变化的数据需求,因为它可以将数据请求的控制权交给客户端,让客户端在任何时间请求任何数据。这让在每次API变更迭代或从这些API请求的数据发生变化时更容易进行更新。与REST API相比,GraphQL允许客户端精确指定所需数据的结构和字段,从而避免了获取过度或获取不足的问题。因此,GraphQL可以提高数据传输的精确性和效率,使应用程序更加灵活和可扩展。
如果应用程序需要从多个来源聚合数据,GraphQL可以帮助把这些来源统一到单个API中。它提供了一个抽象层,可从各种服务中获取和组合数据,使数据的获取和整合更加简单和高效。
当应用程序需要实时更新和订阅时,GraphQL提供内置功能。这些功能允许客户端订阅特定数据的变化,并在数据更改时实时推送通知,从而提高应用程序的实时性和响应性。
总之,如果您需要更好地控制和定制API响应,并希望有效地处理复杂或不断变化的数据需求,那么GraphQL是一个非常有用的工具。
4 使用Spring实现GraphQL随着spring-boot-starter-graphql框架的到来,使用Spring实现GraphQL变得更加容易。
在Spring项目中集成GraphQL的步骤如下:
i)向项目添加gradle/maven graphql starter依赖:
//Gradleimplementation "org.springframework.boot:spring-boot-starter-graphql"//Maven org.springframework.boot spring-boot-starter-graphql
ii)创建一个目录src/main/resources/graphql,并在该目录下添加一个名为schema.graphqls的文件,包含以下内容:
type Query { bookById(id: ID): Book}type Book { id: ID name: String pageCount: Int}
在这里,我们创建了一个Book的schema。每个schema都有一个顶级查询类型,这里的schema定义了一个名为bookById的查询,用于返回特定书籍的详细信息。
iii)GraphQL服务器中的每个复杂类型都由Java bean表示,并且Java bean中的字段将直接映射到GraphQL响应中的字段,其名称基于字段名称。
public record Book (String id, String name, int pageCount) { private static List books = Arrays.asList( new Book("book-1", "Effective Java", 416), new Book("book-2", "Hitchhiker"s Guide to the Galaxy", 208), new Book("book-3", "Down Under", 436) ); public static Book getById(String id) { return books.stream() .filter(book -> book.id().equals(id)) .findFirst() .orElse(null); }}
iv) Spring的GraphQL提供了基于注解的编程模型。通过控制器注释方法,我们可以声明如何获取特定GraphQL字段的数据。现在让我们添加BookController.java
@Controllerpublic class BookController { @QueryMapping public Book bookById(@Argument String id) { return Book.getById(id); }}
通过定义一个名为bookById的方法并用@QuerMapping注释,此控制器声明了如何获取Query类型下定义的Book。查询字段从方法名称确定,但也可以在注释本身上声明。
v) Spring的GraphQL还为我们提供了一个用于编写和执行查询的可视界面,名为GraphiQL。通过将以下配置添加到application.yaml文件中启用GraphiQL:
spring graphql graphiql enabled: true
启动Spring应用程序并导航到http://localhost:8080/graphiql.
vi)在窗口顶部键入查询并单击播放按钮。
query bookDetails { bookById(id: "book-1") { id name pageCount }}
您将看到以下响应:
这样您已经构建了一个GraphQL服务并成功查询了数据!您的数据之旅从此开始!快动手试试吧~
关键词:
您可能也感兴趣:
为您推荐
时空边际兑换码最新2023(微信10个礼包码领取)-世界今头条
中信建投证券:氢能板块进入明确投资窗口期
全球最新:空调自动关机怎么办(空调自动关机)
排行
最近更新
- 今日视点:GraphQL全解析,你学会了吗?
- 环球头条:清洁工嫌声音太吵关掉实验室超低温冰箱电源,导致2...
- 知名地产巨头确认违约
- 「港股异动」微创机器人-B(02252.HK)涨10.38%
- 世界热推荐:【高质量发展调研行】八闽“梧桐”繁茂 企业“...
- 知名财经作家吴晓波微博被禁言 要闻
- 天天即时看!婚姻易失和的5生肖组合,生肖蛇与生肖鸡把家变辩...
- 新疆打造“文化+美食+旅游”城市名片 多地开启“人从众”模式
- 各地各部门通过多种形式不断提高人民群众识毒、防毒、拒毒意识
- 整套月租925元起!北京石景山公租房快速配租已启动
- 郎酒股份发布最新人事任命 高管队伍呈专业化、知识化、年轻...
- 全球关注:重庆法院近五年审结毒品犯罪案件呈持续下降态势
- 有一种母爱叫“再婚后”,大S为爱郎消费千元,却无暇顾及儿女
- 新产业(300832.SZ):取得1项发明专利证书-实时焦点
- 资讯:江苏发布5月设区市降尘量排名 镇江扬州徐州降尘量较大
- 关于下发2023年普通高校在川招生计划更正及调整的通知
- 长沙25.06亿成功出让2宗限价地 保利、美的各拿1宗
- 新疆哈巴河县的警察之家——桦城警苑正式启用
- 世界最资讯丨猪肺怎样做才好吃?
- 重磅!深圳积分入户申报明日开启,详情公布
- 中共中央纪委发布通知 规范和明确党员受留党察看处分期满后...
- 每日热点:中国开源,迈入“新生代” | 「钛度号」作品周榜第60期
- 海南禁毒工作取得“四降四升两深入”历史性成效
- 华亭莲花台发现国家二级保护稀有动物“神兽”——中华鬣羚
- 微软称完成其量子超算路线图第一个里程碑
- gamerant盘点《FF16》未登场怪物 夺心魔、仙人刺等
- 《星之海洋:第二个故事R》中文世界观介绍影像公布
- 天天新消息丨工信部已认定“专精特新”中小企业超8万家 将实...
- 长沙车站南路社区:紧绷燃气安全弦,加强网格巡查力度 前沿资讯
- 最资讯丨河北唐山:投礁种草修复渤海生态 “海底沙漠”现“...