@query 选择个别字段返回什么类型_GraphQL的探索之路 SpringBoot集成GraphQL之Query篇三 第316篇...

相关历史文章(阅读本文之前，您可能需要先看下之前的系列?)

国内最全的Spring Boot系列之三

2020上半年发文汇总「值得收藏」

打破双亲委派【JVM:类加载机制深度剖析】 - 第9篇

JVM整体结构及内存模型【JVM:内存模型深度剖析】 - 第10篇

GraphQL的探索之路 – 一种为你的API而生的查询语言 - 第314篇

GraphQL的探索之路 – SpringBoot集成GraphQL小栗子篇二 - 第315篇

师傅：徒儿，研究如何了，看你最近都悠哉悠哉的，没啥动静呐。

悟纤：师傅，徒儿现在那是：了如指掌、一清二楚、一目了然….

师傅：不知道你这是自信呐，还是飘了呐？

悟纤：自信如我，快乐前行。

师傅：那好，为师在考考你。

悟纤：尽管放马过来。

师傅：有这么介个问题哦

Q1：对于GraphQL使用curl如何发送请求？

Q2：是否可以建立多个.graphql文件进行管理呐？

Q3：合并查询、复杂查询你懂么？

悟纤：这个嘛…. , 这个嘛….

师傅：看来你还是没有研究明白，还不赶紧去搞明白，搞不明白，晚饭就别吃了。

悟纤：┭┮﹏┭┮ ，师傅….. ，我这就去…

章节大纲

一、多个.graphqls文件探索

二、如何加注释

三、使用curl如何进行查询

四、合并查询

五、复杂查询

一、多个.graphqls文件探索

1.1 说明

       我们项目如果有Book和Author的查询的话，那么我们应该不会把配置都放到一个root.graphqls和schema.graphqls文件中吧，这样不利于团队配合开发，那么是否可以book放到book.graphqls中，author放到author.graphqls中呐？

1.2 建立多个.grphqls文件

建立/resources/graphql/author.graphqls，内容如下：

type Author {    id: Int!    name: String    photo: String}extend type Query{    findAuthorById(id: Int!):Author}

说明：这里使用extend继承Root Query，如果不使用extend的话，多个文件的话就不能都生效了。另外对于类型的声明也移到了一起统一管理。

建立/resources/graphql/book.graphqls，内容如下：

type Book {    id: Int!    name: String    isbn: String}extend type Query{    findBookById(id: Int!):Book}

       对于root.graphqls和schema.graphqls文件内容为空或者删除掉文件。

1.3 运行测试

       我们这时候启动运行测试，会报一个异常信息：

SchemaClassScannerError:Type definition for root query type 'Query' not found!

       意思我们没有定义Root Query，解决的方式很简单在root.graphqls文件中天极爱一个空的Query即可：

#定义查询的方法type Query {}

       这时候在运行应该是可以正常运行的，在右侧Query进入可以看到两个Query：

findAuthorById(id: Int!): AuthorfindBookById(id: Int!): Book

二、如何加注释？

       我们在方法也没有注释说明，字段也没有注释说明，肯定不利于前端使用，那么怎么加注释呐，很简单，只要“#注释内容即可”，举例说明：

#作者type Author {  #作者的id    id: Int!    #作者名称    name: String    #作者照片    photo: String}#查询方法extend type Query{  #通过作者id进行查询作者的信息    findAuthorById(id: Int!):Author}

       重启之后，在图形化界面可以看到我们刚添加的注释了：

(这里截图中的对应的是Int!，不是Long!，这是后期配置文件修改了)

三、使用curl如何进行查询呐？

3.1 说明

       我们已经知道使用图形化界面如何进行查询了，那么如果使用curl如何查询呐？

3.2 分析

       我们观察下浏览器是如何发起请求的：

       从这里可以看到好像是发送了一个字符串到后端，然后就可以返回一个json的结果了。

3.3 使用curl进行查询

发起请求的指令(mac下)：

curl -i -X POST -d  '{"query": "query {findAuthorById(id:1) {id,name}}"}' http://127.0.0.1:8080/graphql

说明：

(1)curl：cURL是一个利用URL语法在命令行下工作的文件传输工具。

(2)-i：显示 http response 的头信息，连同网页代码一起，-I 参数则只显示 http response 的头信息。

(3)-X：指定 HTTP 请求的方法(要大写，举例：POST/GET，错误示例：post/get)。

(4)-d：用于发送 POST 请求的数据体。

       执行我们看下帅帅的结果：

       结果是返回了，但是是不是觉得挨着某些不该挨着的信息，看起来很不舒服呀，偷偷告诉你个小技巧，只需要在上面的命令后面加上&& echo，就会换行了，具体命令如下：

curl -i -X POST -d  '{"query": "query {findAuthorById(id:1) {id,name}}"}' http://127.0.0.1:8080/graphql && echo

       这结果看起来是不是很酷，爽歪歪的….

四、合并查询

4.1 说明

       我们经常会查询多个接口，然后进行展示的需求。

一种方法就是后端写一个接口，进行查询返回，另外一种方法就是前端调用多个接口进行查询渲染。

4.2 GraphQL实现合并查询

当碰上GraphQL就显得很简单了，我们看看如何实现合并查询，只需要需改下GraphQL语句即可：

query{   findAuthorById(id:1){    id,    name  },  findBookById(id:1){    id,    name,    isbn  }}

       是不是很酷。这里想问下大家，对于前端发起的请求是一次，还是两次呐？(不确定留言区评论，我来告诉你)

       另外findAuthorById和findBookById的顺序会影响后端的执行顺序吗(这个是会有影响的，谁在前面，谁先执行)

4.2 同名不同字段的时候，结果是什么？

       我们有这么一个指令：

query{  findAuthorById(id:1){    id,    name  },  findBookById(id:1){    id,    name,    isbn  },  findAuthorById(id:1){    id,    photo  }}

       大家可以猜想下，这个结果会返回什么，后端执行多少次？

       结果是：后端只会执行两次，结果返回是并集，如下截图：

五、复杂查询

5.1 说明

       一般我们的关系是这样子的，一本书会有一个或者n个作者，这里我们假设1个，那么对于我们想要返回author和book信息，怎么操作呢？

5.2 第一步：修改java代码建立关系

       对于Book.java中需要增加一个属性Author：

private Author author;

       在BookService中，设置author的值：

public class BookService {  @Autowired  private AuthorService authorService;    public Book findById(int id) {    Book book = new Book();    book.setId(id);    if(id==1) {      book.setName("从零开始学SpringBoot");      book.setIsbn("9881200");      book.setAuthor(authorService.findById(1));    }else if(id==2) {      book.setName("JVM性能调优");      book.setIsbn("9881201");      book.setAuthor(authorService.findById(2));    }    return book;  }}

       这里的demo没有使用数据源，都是直接本地构建的对象，实际中，换成数据库库的查询即可。

5.3 第二步：修改graphqls文件

       修改book.graphqls文件typeBook添加author属性：

#书本信息type Book {  #书本id    id: Int!    #书本名称    name: String    #书本isbn编码    isbn: String    #作者    author:Author}

       如果是多个作者的话，java中使用List，配置文件使用[Author]定义即可。

5.4 第三步：GraphQL语句

       到这里就可以使用GraphQL语句查询下了：

要返回啥字段还是你说的算，如果不想要返回author，只要不配置就可以了。

悟纤小结

悟纤：探着，探着，就弹多了，今天就先到这里吧，还有一小部分内容：修改怎么玩以及GraphQL的配置文件、还有就是****。我们对本节做个总结吧：

(1)要知道多个.graphqls要怎么操作，核心就是extend type Query；

(2)注释可以使用“#注释信息“进行说明，这样在使用GraphiQL的时候，就可以看到字段的注释说明了，避免了和前端的沟通。接口注释 、属性注释，一个都不能少，妈妈再也不用担心我不能回家吃饭了。

(3)使用curl进行查询，发起一个POST的 带有一个GraphQL语句的字符串即可。另外分享了一个小技巧：在命令之后加上&&echo可以换行哦。

(4)合并查询和复杂查询：这些本身就是GraphQL的特点，知道有这些特点即可。