从Rest到Graphql
Posted 孤独烟
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了从Rest到Graphql相关的知识，希望对你有一定的参考价值。
引言
开局两张图，内容全靠编～
ok，如图所示，我在去年曾经写过一篇文章 嗯，我知道肯定很多人没看过。所以我做一个总结，其实啰里八嗦了一篇文章，就是想说一下现在的大型互联网项目一般是如下两种架构之一
前后端半分离架构
前后端分离架构
区别分离和半分离的标志在于Controller层由不由前端控制，Controller在前端手里，前端手里握着组装数据的逻辑，那就是前后端分离！否则就是半分离！
那么，半分离和分离的架构是长下面这样的
ps:中小型公司慎重，不要玩前后端分离架构！前端工作量贼大！
正文
RestFul的缺陷
假设，此时我们有两个资源分别是Book和Author，这两个资源对应的ER图如下
POST /books
GET /books/{id}
POST /authors
GET /authors/{id}
GET /books/1
返回结果是这样的
[{
"id": 1,
"bookname": Harry Potter,
"price": 56.00,
"author_id": 2
}]
这时候前端MM拿到这个结果后，傻了眼！这里怎么能直接返回author_id呢，难道直接把author_id显示在界面上么？不可能啊，界面上要显示的是author_name才行！
OK，那么在这种情况下，有两种方式可以解决问题！
(1) 跟后端沟通，让他增加一个接口
嗯，我们复习一下什么是VO对象。
VO（View Object）：视图对象，用于展示层，它的作用是把某个指定页面（或组件）的所有数据封装起来。
那可以让后端封装一个接口，后端帮你把数据拼装好，提供API如下
GET /bookVOs/1
这样直接返回的结果就是
[{
"id": 1,
"bookname": Harry Potter,
"price": 56.00,
"author_name": J. K. Rowling
}]
当然，因为你这是临时让后端加接口，可能会有如下情形产生
OK，回到正题，这样做的缺点主要有两个
前后端强耦合在一起，前端界面发生变动，后端VO对象跟着一起变
如果BookVO对象在手机端、PC端、APP端的显示内容都不一样，你可能在项目中会有BookPcVO类、BookH5VO类、BookAppVO类，VO类大大膨胀！
GET /authors/2
得到结果，然后进行组装显示！
当然，这个时候会有如下情形产生(这就是我注孤生的原因！)
返回了一堆前端并不需要的数据
徒增前后端的交互次数
ok，通过上面的描述，大家应该能体会到Rest的缺点:REST接口时返回的数据格式、数据类型都是后端预先定义好的，如果返回的数据格式并不是调用者所期望的，调用者在处理上比较麻烦！
那么，有没有办法让前端自定灵活的使用查询语句，自己想捞什么数据就捞什么数据呢？
有的，那就是Graphql！
Graphql的出现
Graphql其实要这样理解Graphql=grap(图)+query+lanage
是一种基于图的查询语言！那么，这张图长什么样？
OK，首先你要声明一下，你的图结构，嗯，用的就是Graphql的语法啦，像下面这样
type Book {
id: Int
bookname: String
authors: [Author]
}
type Author {
id: Int
name: String
age: String
}
type Query {
getBook(id: Int): Book
}
schema {
query: Query
}
对上面的语句进行一下解释。这里一共声明了三个类Book、Author、Query！其实，Book和Author大家都可以猜都出来是指啥，需要注意的一点是authors: [Author]这个地方，用了一个[]的语法，这代表Author是一个数组！
唯一需要说明的是，Query是什么鬼？Query在这儿表明了该类型是这张图的入口，也就是根节点！我们的查询必须从根节点里的属性开始！这里我为了便于说明，只列了一个属性，也就是getBook，该属性是入口，必须从入口开始查！
那么，生成的图是长下面这样的
这里还有一个Resolver的概念，就是说，GragphQL解析到getBook方法的时候，方法体内容是啥？是在Resovler中定义的，我这里就不贴配置了，感兴趣的可以自己去官网阅读！
OK,接下来就是第二个问题，怎么查？
根据上面我说的，只能从根开始，根是getBook，那语句怎么写呢？如下所示
那你想加个字段，显示作者名字呢？直接像下面这么写
采用这种语法结构，后端的数据模型就变成了一张图，前端可以定制化自己的输出结构，同时可以减少前后端的沟通成本，提高灵活性！
一些疑问
(1)java语言中，对Graphql的支持如何？
在java中，有个jar包为graphql-java-tools提供了对Java的支持。
另外，考虑到现在大多是springboot项目，有大神封装好了starter包，供你们的springboot项目使用！
只需在项目中引入
<!-- graphql -->
<dependency>
<groupId>com.graphql-java</groupId>
<artifactId>graphql-spring-boot-starter</artifactId>
<version>4.0.0</version>
</dependency>
<dependency>
<groupId>com.graphql-java</groupId>
<artifactId>graphql-java-tools</artifactId>
<version>4.3.0</version>
</dependency>
即可让你的springboot项目拥有graphql的功能，非常方便！
(2)这样做不会加重前后端工作量么？
说句实在话，摸着良心说，前期确实加重了前后端的工作量！
对前端而言：需要去了解Graphql的语法！
对后端而言：不仅需要了解Graphql的语法，还需要去编写Schema和Resovler！
所以短期内，确实增加了工作量！但是从长远来看，同时降低了前后端的工作量！
第一，前端不用了解后端的数据结构，GraphQL自己生成可交互式的接口文档，前端可以自己测试调用
第二，后端不用在编写什么接口文档，GrapQL自动帮你生成，用起来非常舒心！
第三，减少前后端沟通次数，为中国程序员界再添单身男青年！
总结
本文介绍了Rest的缺点，以及Graphql的基本知识，希望大家有所收获！
以上是关于从Rest到Graphql的主要内容，如果未能解决你的问题，请参考以下文章