Spring Boot GraphQL 实战 02_增删改查和自定义标量

Spring Boot GraphQL 实战系列第二篇，使用 GraphQL 实现增删改查。

hello，大叫好，我是小黑，又和大家见面啦~

今天我们来继续学习 Spring Boot GraphQL 实战，我们使用的框架是 https://github.com/graphql-java-kickstart/graphql-spring-boot

项目 github 地址：https://github.com/shenjianeng/graphql-spring-boot-example

Query（查询）

带参数的查询

首先，在 classpath 下创建 graphqls 文件：

type Book{ id:ID! name:String!}type Query{ # 根据 id 查询 book,参数名为 id,参数类型的 ID 类型,结果返回 book getBookById(id:ID!):Book}

创建一个 Spring Bean，此处需要实现 GraphQLQueryResolver 接口，并在该类中自定义一个方法来映射 graphqls 文件中的查询。

@Datapublic class Book { private int id; private String name;}@Componentpublic class BookGraphQLQueryResolver implements GraphQLQueryResolver { public Book getBookById(int id) {  Book book = new Book();  book.setId(id);  book.setName("这边书没有书名");  return book; }}

复合字段查询

需求：每本书都有作者，在查询书本信息时，有时需要返回作者信息。

# 定义 Author 数据类型结构type Author{ id:ID! name:String!}type Book{ id:ID! name:String! # 增加 author 字段,数据类型为 Author author:Author}type Query{ # 根据 id 查询 book,参数名为 id,参数类型的 ID 类型,结果返回 book getBookById(id:ID!):Book}

再看一下此时我们的 Java Bean：

@Datapublic class Author { private UUID id; private String name;}@Datapublic class Book { private long id; private String name;}

看仔细哦，Book 类中并没有 author 字段，Book 中 author 信息将由 graphql.kickstart.tools.GraphQLResolver 来提供。

@Slf4j@Componentpublic class BookGraphQLResolver implements GraphQLResolver<Book> { public Author author(Book book) {  log.info("book id :{} query author info", book.getId());  Author author = new Author();  author.setId(UUID.randomUUID());  author.setName(String.format("我是[%s]的作者", book.getName()));  return author; }}

ok，让我们启动服务，访问 src="https://cdn.jsdelivr.net/gh/shenjianeng/pictures/2020-12-19/1608362776229-image.png" alt="同时查询book和author" loading="lazy">

而当客户端不需要 author 信息时，服务端就不会执行 BookGraphQLResolver#author，真正做到了使得客户端能够准确地获得它需要的数据，而且没有任何冗余。

（ps：如果你是服务端开发，你会怎么实现呢？是给客户端提供一个接口返回 book 和 author 信息，还是给客户端提供两个不同的接口呢？）

只查询book时

Mutation（变更）

在 graphqls 文件中，使用 Query 来定义查询接口，使用 Mutation 可以定义变更数据的操作。

type Mutation{ createBook(id:ID!,name:String!):Book}

上述 graphqls 文件中定义了一个 createBook 的方法，参数列表为 id 和 name ，方法返回创建的 Book 对象。

与之对应的 Java 代码如下：

@Componentpublic class BookGraphQLMutationResolver implements GraphQLMutationResolver { public Book createBook(int id, String name) {  Book book = new Book();  book.setId(id);  book.setName(name);  return book; }}

BookGraphQLMutationResolver 实现了 graphql.kickstart.tools.GraphQLMutationResolver 接口，表明当前类中的方法用来映射 graphqls 文件中的 Mutation。

mutation

Input Types

当 Mutation 中请求参数特别多时，我们可以使用 Input Types 来优化代码。

type Mutation{ createBook(id:ID!,name:String!):Book create(bookInput:BookInput!):Book}input BookInput{ id:ID! name:String!}

同理，我们也需求在 BookGraphQLMutationResolver 中添加对应的方法来映射。

@Componentpublic class BookGraphQLMutationResolver implements GraphQLMutationResolver { 	// ...省略其他代码  public Book create(BookInput input) {  Book book = new Book();  book.setId(input.getId());  book.setName(input.getName());  return book; }}

客户端请求代码如下：

mutation和input

自定义标量类型

在 GraphQL 中自带一些默认标量类型：

  • Int：有符号 32 位整数

  • Float：有符号双精度浮点值

  • String：UTF‐8 字符序列

  • Boolean：true 或者 false

  • ID：ID 标量类型表示一个唯一标识符，通常用以重新获取对象或者作为缓存中的键。ID 类型使用和 String 一样的方式序列化

使用 graphql-java-extended-scalars 库

在 Java 这个生态中，我们可以引入下面这个库来帮助我们很方便的进行扩展：

https://github.com/graphql-java/graphql-java-extended-scalars

 <dependency> <groupId>com.graphql-java</groupId> <artifactId>graphql-java-extended-scalars</artifactId> <version>15.0.0</version> </dependency>

graphql-java-extended-scalars 中具体扩展了哪些标量类型，我们都可以在 graphql.scalars.ExtendedScalars 类中找到。

（ps：一个小技巧，s 结尾的类一般都是工具类）

ExtendedScalars

如何使用呢？

  1. 向 Spring 容器中注册自定义标量
  2. 在 graphqls 文件中声明要使用的自定义标量
  3. 直接使用即可

相关示例代码如下：

@Configurationpublic class CustomScalarTypeConfig { @Bean public GraphQLScalarType graphQLLong() {  return ExtendedScalars.GraphQLLong; }}
scalar Longtype Book{ id:ID! name:String! # 增加 author 字段,数据类型为 Author author:Author totalPageSize:Long}

使用 GraphQLScalarType 自定义标量类型

我们可以参考 graphql.scalars.java.JavaPrimitives#GraphQLLong 的实现来自定标量类型。

@Beanpublic GraphQLScalarType graphQLDate() { return GraphQLScalarType   .newScalar()   .name("Date")   .description("Date 类型")   .coercing(new Coercing<Date, String>() {    @Override    public String serialize(Object dataFetcherResult) throws CoercingSerializeException {     return new SimpleDateFormat(DATE_FORMAT_PATTERN_DEFAULT).format((Date) dataFetcherResult);    }    @Override    public Date parseValue(Object input) throws CoercingParseValueException {     if (input instanceof String) {      try {       return new SimpleDateFormat(DATE_FORMAT_PATTERN_DEFAULT).parse((String) input);      } catch (ParseException e) {       throw new CoercingParseValueException(e);      }     }     throw new CoercingParseValueException(       "Expected a 'String' but was '" + Kit.typeName(input) + "'."     );    }    @Override    public Date parseLiteral(Object input) throws CoercingParseLiteralException {     if (!(input instanceof StringValue)) {      throw new CoercingParseLiteralException(        "Expected AST type 'StringValue' but was '" + typeName(input) + "'."      );     }     try {      return new SimpleDateFormat(DATE_FORMAT_PATTERN_DEFAULT).parse(((StringValue) input).getValue());     } catch (ParseException e) {      throw new CoercingParseValueException(e);     }    }   })   .build();}

DataFetcherResult

在 Resolver 中，我们可以使用 graphql.execution.DataFetcherResult 来包装返回的结果，示例代码如下：

@Componentpublic class BookGraphQLQueryResolver implements GraphQLQueryResolver { public DataFetcherResult<Book> getBookById(int id) {  if (id <= 0) {   return DataFetcherResult     .<Book>newResult()     .error(new GenericGraphQLError("id 不能为负数"))     .build();  }  Book book = new Book();  book.setId(id);  book.setName("这边书没有书名");  return DataFetcherResult    .<Book>newResult()    .data(book)    .build(); }}

下期预告

下期我们将使用 graphQL 来实现分页，并介绍一些高级特性，例如：异步加载、全局异常处理等。感谢大家的关注和阅读~~

更多学习参考资料：

https://www.graphql-java-kickstart.com/tools/schema-definition/#resolvers-and-data-classes

https://graphql.org/learn/schema/









原文转载：http://www.shaoqun.com/a/504291.html

跨境电商：https://www.ikjzd.com/

auction：https://www.ikjzd.com/w/2311

五洲会海购：https://www.ikjzd.com/w/1068


SpringBootGraphQL实战系列第二篇，使用GraphQL实现增删改查。hello，大叫好，我是小黑，又和大家见面啦~今天我们来继续学习SpringBootGraphQL实战，我们使用的框架是https://github.com/graphql-java-kickstart/graphql-spring-boot项目github地址：https://github.com/shenjian
patpat：patpat
Zozo：Zozo
东部华侨城好不好玩？：东部华侨城好不好玩？
全球唯一"十星级酒店"大揭秘 弱爆五星级：全球唯一"十星级酒店"大揭秘 弱爆五星级
EPC：EPC

Comments

Post a Comment

Popular posts from this blog

指纹浏览器定制开发全面助力企业安全与智能升级

在数字化时代，企业信息安全和智能化管理愈发成为商务发展的两大支柱。为适应这一趋势，指纹浏览器定制开发成为了企业安全和智能升级的最佳选择。让我们一同探索，如何通过指纹浏览器的二次开发、私有部署和AI智能等关键功能，助力企业迎接未来的挑战。 指纹浏览器二次开发：保障身份识别的极致体验 随着科技的不断进步，传统身份验证方式显得越来越脆弱。指纹浏览器的二次开发为企业带来了身份识别的极致体验，通过精准的生物特征验证，极大地提高了安全性。企业无需担忧密码泄漏或仿冒风险，真正实现了信息安全的无忧管理。 私有部署：数据安全掌握在自己手中 数据是企业最重要的资产之一，而私有部署则是最为可靠的数据保护手段之一。通过将指纹浏览器定制开发系统私有部署，企业能够完全掌握对敏感数据的访问和存储。这一层级的掌控，不仅提升了数据的安全性，同时也避免了因为云服务的共享带来的潜在风险。 原文转载： https://fashion.shaoqun.com/a/1585172.html 深圳巴厘岛海景酒店 ：https://www.vstour.cn/t/深圳巴厘岛海景酒店.html 深圳巴厘岛旅行团 ：https://www.vstour.cn/t/深圳巴厘岛旅行团.html 深圳巴厘岛旅游 ：https://www.vstour.cn/t/深圳巴厘岛旅游.html 深圳巴厘岛旅游报价 ：https://www.vstour.cn/t/深圳巴厘岛旅游报价.html 深圳巴厘岛旅游价格 ：https://www.vstour.cn/t/深圳巴厘岛旅游价格.html 深圳巴厘岛旅游团 ：https://www.vstour.cn/t/深圳巴厘岛旅游团.html 红海堵塞，海湾受益？ ：https://www.kjdsnews.com/a/1743053.html 一篇文章带你了解商标注册：尼加拉瓜 ：https://www.kjdsnews.com/a/1743054.html
Read more

跨境电商资讯：一文带你走进亚马逊19大海

Image
随着全球电商行业的迅速发展，许多品牌逐渐将目光投向海外市场，寻找新的业务增长点。亚马逊作为全球最大的电商平台之一，拥有众多海外站点，为卖家提供了广阔的发展空间和优质的服务。然而，当卖家们面对海外众多不同的站点，它们的区别是什么？该选红海站点还是蓝海站点？如何才能选择适合自己的平台？这些都让许多卖家感到非常迷惑，不知所措。 别着急！接下来就让小编带大家一起了解亚马逊各大海外站点的机会优势，并分享几位卖家的实战经验，助您选好出海站点，赢在起跑线！ 目前，亚马逊在全球拥有19大海外站点，覆盖北美、拉丁美洲、欧洲、亚洲、大洋洲等多个地区，帮助卖家触达数亿消费者。这些站点各有"特长"，您可以结合自身业务、资金情况和发展需求等因素，Pick适合自己的出海站点，及时把握海外商机！ 01老牌成熟站点，新手出海首选！ 目前，亚马逊在北美地区拥有美国站和加拿大站两大站点。北美站的整体成熟度和服务完善性让许多卖家将它作为开拓生意的首站。 从宏观环境来看，北美站可谓实力超群： ●体量庞大，消费潜力高 作为亚马逊全球最大海外站点，消费实力强劲，两大站点囊括3.7亿+人口，人红利充足，Prime会员占比高； ●品类齐全，细分赛道机会多 加拿大站选品文化接近美国，选品空间广阔，有利于卖家挖掘不同品类商机! 对于新手来说，亚马逊北美站拥有多重优势助力启航： ●配套完善，服务齐全 作为最早开设的站点，亚马逊服务支持齐全，新卖家上手更轻松 ●物流便捷，配送无阻 您可使用亚马逊远程物流配送计划(NARF)，将美国站FBA库存直接配送给加拿大买家，无需将库存事先运送到加拿大，助您轻松拓展北美地区商业版图! 该计划具有以下4大优势： ●利用美国FBA库存，为加拿大的Prime买家提供免费配送服务； ●由亚马逊处理跨境配送事宜，让配送流程更简单便捷； ●进口税费和相关费用由买家支付，无需卖家承担； ●退货直接退回美国，省心省力。 如果您想坐拥巨大流量，触达更多、更广泛的消费者；如果您的选品种类丰富齐全，希望同时布局多种品类赛道……那么北美站是您不该犹豫的首选! 02高潜消费增长能力，业务拓展不二之选！ 在拉丁美洲，除了已对卖家开放的墨西哥站之外，亚马逊巴西站也于2023年12月正式对中国卖家开放，不少北美站卖家已抢先拓展生意版图，吃到了"第一只螃蟹"! 结合宏观发展趋势...
Read more

利用 Google 购物广告促进销量的初学者指南

您需要更多客户。 并且，您需要 以可接受的成本获取它们 。因为，如果你不能做这两件事呢？ ……好吧， 我们别去那里了 。 首先，如何获得更多客户？ 嗯，一种行之有效的方法是 Google Shopping 。 这一领先的电子商务流量来源 占 电子商务 网站整体销售额的 16% 以上。 那是 巨大的。 但是，当您考虑到Google每秒处理超过 40,000 个搜索查询 时，这也就不足为奇了。 不过，这还不是全部…… 2018 年，在美国电子商务领域，Google 购物广告占 零售搜索广告支出的 76.4% ，占所有付费搜索点击次数的 85.3%。 另一方面，文字广告仅吸引了 23.6% 的零售搜索广告支出和 14.7% 的付费搜索点击次数。 由于 Google 努力通过富媒体广告格式提高知名度，投资 Google Shopping 广告系列已成为零售搜索行业的主要趋势。 但是，您能否使用 Google 购物以可接受的成本获取客户，从而为您带来利润？ 一言以蔽之？ 是的 。 OMG Commerce首席执行官 Brett Curry 去年 管理的广告活动平均 广告支出回报率 (ROAS) 为 300-600% 。 您愿意花 1美元获得 3 至 6 美元的销售额吗？ 我愿意打赌你会的。 你是怎么做到的？ 在本文中，您将准确了解 Google 购物是什么、它的工作原理以及如何开始您的第一个广告系列。 好吧，系好安全带 。 Fansgurus是一个社交媒体营销在线平包含了Facebook，Instagram，Twitter，Pinterest，YouTube，Tiktok，telegram，虾皮等等海外社交媒体，并提供增粉、点赞、转发、评论浏览量直播间在线，网站引流等数据服务。快速体验： zllp.myyfrs.ciwi._okgyw?fyuokfj 什么是谷歌购物？ Google 购物广告也称为产品详情广告或 PLA。而且，当用户在 Google 上搜索产品时，它们就会显示。 它们出现 在搜索结果的顶部或页面的右上角： Google 购物广告也可以 在"购物"标签下找到。 这些广告如此有效的 部分原因 是它们位于搜索结果顶部的显着位置。 那么，Google 购物广告包含哪些内容？ 简而言之， 消费者熟悉的5 个关键组件： 产品图片 产品名称 价格 卖家姓...
Read more