Graphql Tutorials(Episode 02)
1.前言
我们在上篇已经了解Graphql的使命以及Graphql的概况,接下来,我们跑起来另外一个Helloworld来开启继续学习。
2.Helloworld(使用Graphql 原生API)
这里呢,我们会用Graphql的原生API来搭建helloword
Java 8
SpringBoot
OKTA:洛杉矶的一个公司,为系统提供信息安全验证。
GraphQL Playground: 类似于Postman的工具,这里呢用Postman也可以,但是,我更喜欢GraphQL Playground黑色页面的风格。
Download:https://www.electronjs.org/apps/graphql-playground
完整Demo的地址:
https://github.com/lihao5257/GraphqlDemo.git 代码在master分支
我们进入正题。首先是schema.graphqls, 里面定义了Graphql API的结构。
# This is a comment
type Query {
bookById(id: ID): Book
allBooks: [Book]
} type Book {
id: ID
name: String
pageCount: Int
author: Author
} type Author {
id: ID
firstName: String
lastName: String
}
然后我们需要将上述文件进行解析,将解析后的关键字与逻辑的处理进行匹配。
1 public void init() throws IOException {
2 URL url = Resources.getResource("schema.graphqls");
3 String sdl = Resources.toString(url, Charsets.UTF_8);
4 GraphQLSchema graphQLSchema = buildSchema(sdl);
5 this.graphQL = GraphQL.newGraphQL(graphQLSchema).build();
6 }
7 // 解析SDL文件,然后,进行属性的绑定。
8 private GraphQLSchema buildSchema(String sdl) {
9 TypeDefinitionRegistry typeRegistry = new SchemaParser().parse(sdl);
10 RuntimeWiring runtimeWiring = buildWiring();
11 SchemaGenerator schemaGenerator = new SchemaGenerator();
12 return schemaGenerator.makeExecutableSchema(typeRegistry, runtimeWiring);
13 }
14
15 private RuntimeWiring buildWiring() {
16 return RuntimeWiring.newRuntimeWiring()
17 .type(TypeRuntimeWiring.newTypeWiring("Query")
// bookById的查询,与右边的逻辑进行绑定。当API调用bookById这个方法时,程序就知道该如何进行查询了。
18 .dataFetcher("bookById", graphQLDataFetchers.getBookByIdDataFetcher()))
19 .type(TypeRuntimeWiring.newTypeWiring("Book")
20 .dataFetcher("author", graphQLDataFetchers.getAuthorDataFetcher()))
21 .type(TypeRuntimeWiring.newTypeWiring("Query")
22 .dataFetcher("allBooks", graphQLDataFetchers.getAllBooksDataFetcher()))
23 .build();
24 }
接下来,我们要编辑与bookById绑定的方法,比如,从DB里查数据,或是从缓存中查找等等。
1 public DataFetcher<Object> getBookByIdDataFetcher() {
2 return dataFetchingEnvironment -> {
3 String bookId = dataFetchingEnvironment.getArgument("id");
4 return books
5 .stream()
6 .filter(book -> book.get("id").equals(bookId))
7 .findFirst()
8 .orElse(null);
9 };
10 }
11
12 public DataFetcher<Object> getAuthorDataFetcher() {
13 return dataFetchingEnvironment -> {
14 Map<String, String> book = dataFetchingEnvironment.getSource();
15 String authorId = book.get("authorId");
16 return authors
17 .stream()
18 .filter(author -> author.get("id").equals(authorId))
19 .findFirst()
20 .orElse(null);
21 };
22 }
23
24 public DataFetcher<Object> getAllBooksDataFetcher() {
25 return dataFetchingEnvironment -> {
26 return books;
27 };
28 }
到这里,我们API编辑的部分就算完成了。主要的流程就是按照上一篇博文中讲解的Graphql初始化流程来的。
大家可以发现,这种原生API的方式,非常的繁琐,我们必须手动地将查询方法(如:bookById)和对应的逻辑(graphQLDataFetchers.getBookByIdDataFetcher())绑定在一起。这就非常麻烦。为了简化流程,开发者会使用另外一种基于API,它基于原生API,在其基础上进行了包装,让开发者只需要关注于业务。
3.Helloworld(使用GraphQL Java Tools)
demo地址:
https://github.com/lihao5257/GraphqlDemo.git 选择tutorial-graphql-java-tools-hello分支
同样,先是schema.graphqls文件的创建
# This is a comment
type Book {
title: String!
isbn: String!
} type Query {
getBook(isbn: String!): Book
getAllBooks : [Book]
} type Mutation {
createBook(book:BookWrapper):Book
} input BookWrapper{
title:String!
isbn:String!
}
我们接下来要创建Book的模型
1 public class Book {
2
3 private String title;
4 private String isbn;
5
6 public Book(String title, String isbn) {
7 this.title = title;
8 this.isbn = isbn;
9 }
10
11 public String getTitle() {
12 return title;
13 }
14
15 public void setTitle(String title) {
16 this.title = title;
17 }
18
19 public String getIsbn() {
20 return isbn;
21 }
22
23 public void setIsbn(String isbn) {
24 this.isbn = isbn;
25 }
26
27 }
然后,要创建一个Resolver,意思是调用API(如:调用getBook())时,处理请求的业务逻辑是什么样的。
// 处理查询的方法时,需要继承GraphQLQueryResolver 这个接口
public class BookResolver implements GraphQLQueryResolver { static List<Book> books = null;
static {
books =new ArrayList<Book>();
books.add(new Book("Harry Porter 1", "1111"));
books.add(new Book("Harry Porter 2", "2234"));
books.add(new Book("Harry Porter 3", "2434324"));
books.add(new Book("Harry Porter 4", "112343211"));
books.add(new Book("Harry Porter 5", "5646"));
} // method名字跟API调用的名字一致,在方法里面写具体业务逻辑即可
public Book getBook(String isbn) {
return new Book("Learn GraphQL", "309234324");
} public List<Book> getAllBooks() {
return books;
}
}
然后,就OK啦,非常的简便。省去了一切非业务的操作。这个处理方法有些像JPA,操作对象的的感觉。至此,我们的helloword完成了。希望大家亲自跑一跑,感受一下。
3.完整demo
这个完成的demo中,有增删改查的完整功能,以及异常处理等操作。大家感兴趣的话,可以看看。
https://github.com/lihao5257/GraphqlDemo.git graphql-java-tools-full-demo分支
4.小结
Graphql入门基础,并不难。GraphQL Java Tools的这样类似JPA的,通过对象来操作事情的思想很好,这个月找机会研究一下JPA以及GraphQL Java Tools的源码,学习一下。
References:
https://www.graphql-java.com/tutorials/getting-started-with-spring-boot/#graphql-in-3-minutes
https://www.graphql-java.com/documentation/v15/
https://graphql.org/
https://www.graphql-java-kickstart.com/
Graphql Tutorials(Episode 02)的更多相关文章
- Graphql Tutorials(Episode 01)
1.前言 最近认识到Graphql,它是一个基于DSL的api.我曾接触过一个pos机刷卡系统,它是基于JSON-DSL语言开发的框架,很有趣.可是后来,没有机会深入研究.直到最近我认识了Graphq ...
- 用 eric6 与 PyQt5 实现python的极速GUI编程(系列02)---- 省市县(区)下拉列表多级联动
[概览] 本文实现如下的程序: 主要步骤如下: 1.在eric6中新建项目,新建窗体 2.(自动打开)进入PyQt5 Desinger,编辑图形界面,保存 3.回到eric 6,对上一步得到的界面文件 ...
- Kotlin中变量不同于Java: var 对val(KAD 02)
原文标题:Variables in Kotlin, differences with Java. var vs val (KAD 02) 作者:Antonio Leiva 时间:Nov 28, 201 ...
- 资料下载:生活方向盘PPT以及活动录音(2011.02)
本文已挪至 http://www.zhoujingen.cn/blog/676.html 免费PDF和活动录音下载: http://down.51cto.com/data/216824 敏捷个人生活方 ...
- C#/JAVA 程序员转GO/GOLANG程序员笔记大全(DAY 02)
------------------- 指针 go 保留的 c 语言指针的操作,同时增加了自动垃圾回收机制 var a = new(int) *a = // &a 内存地址 --------- ...
- DLP显示单元(威创)
品牌:威创型号:E-SX675生产商:广东威创视讯科技股份有限公司1.生厂商简介(1)生产商概述广东威创视讯科技股份有限公司(简称威创)成立于2002年,专业从事大屏幕拼接显示产品及其解决方案的研发. ...
- 带你十天轻松搞定 Go 微服务之大结局(分布式事务)
序言 我们通过一个系列文章跟大家详细展示一个 go-zero 微服务示例,整个系列分十篇文章,目录结构如下: 环境搭建 服务拆分 用户服务 产品服务 订单服务 支付服务 RPC 服务 Auth 验证 ...
- 朱晔的互联网架构实践心得S2E5:浅谈四种API设计风格(RPC、REST、GraphQL、服务端驱动)
Web API设计其实是一个挺重要的设计话题,许多公司都会有公司层面的Web API设计规范,几乎所有的项目在详细设计阶段都会进行API设计,项目开发后都会有一份API文档供测试和联调.本文尝试根据自 ...
- API设计风格(RRC、REST、GraphQL、服务端驱动)
API设计风格(RRC.REST.GraphQL.服务端驱动) Web API设计其实是一个挺重要的设计话题,许多公司都会有公司层面的Web API设计规范,几乎所有的项目在详细设计阶段都会进行API ...
随机推荐
- JVM简单入门
目录 初识JVM 双亲委派机制 沙箱安全机制 Native PC计数器 方法区 栈 堆 工具分析OOM GC算法 GC算法总结 JMM 初识JVM JVM的位置:jre中包含jvm. 双亲委派机制 双 ...
- mysql case when语句的使用
case具有两种格式.简单case函数和case搜索函数. 简单函数 CASE [col_name] WHEN [value1] THEN [result1]-ELSE [default] END 搜 ...
- Hbase启动报java异常
在conf文件夹下的hbase-env.sh文件中的j添加ava_home的环境变量, ******************************************************** ...
- POJ1390 Blocks (区间DP)
题目链接:POJ 1390.Blocks 题意: 有n个方块排成一列,每个方块有颜色即1到n的一个值,每次操作可以把一段相同颜色的方块拿走,长度为k,则获得的分数为 \(k\times k\),求可获 ...
- 新鲜出炉,这是全网讲的最详细的springboot整合消息服务了吧,建议收藏!
springboot整合activeMq ActiveMq是Apache提供的开源消息系统采用java实现, 很好地支持JMS(Java Message Service,即Java消息服务) 规范 A ...
- FL Slayer合成器功能之顶部组件介绍
本章节采用图文结合的方式给大家介绍电音编曲软件--FL Studio中的插件FL Slayer合成器中的顶部组件,它是电吉他模拟合成器,感兴趣的朋友可以一起沟通学习交流. FL Slayer(杀手)合 ...
- 记录一次tomcat问题排查记录:org.apache.tomcat.util.bcel.classfile.ClassFormatException: Invalid byte tag in constant pool: 19
最近项目升级jdk,从jdk7 升级到 jdk8,本地已经自测完成了,需要部署到测试环境,测试环境已经装好 jdk8 了,但是tomcat 的版本还是 7.不过,据我之前了解,tomcat7是可以运行 ...
- NOIP2012 解题报告
TG Day1 T3 开车旅行 1. 预处理出从每座城市两人分别会到达的两座城市. 用 set 可以轻松实现. 2. 用倍增优化 DP 令 \(f_{i,j,k}\) 表示从城市 \(j\) 出发,行 ...
- RabbitMQ+Redis模拟手机验证码登录
RabbitMQ+Redis模拟手机验证码登录 依赖 <dependency> <groupId>org.springframework.boot</groupId> ...
- 现代富文本编辑器Quill的模块化机制
DevUI是一支兼具设计视角和工程视角的团队,服务于华为云DevCloud平台和华为内部数个中后台系统,服务于设计师和前端工程师.官方网站:devui.designNg组件库:ng-devui(欢迎S ...