java world_Java World中的GraphQL简介

java world

许多人认为GraphQL仅适用于前端和JavaScript,它在Java等后端技术中不占优势,但事实确实如此。

还经常将GraphQL与REST进行比较,但是这种比较是否合理?

首先,让我开始回答其中最重要的问题。 什么是GraphQL?

如果您查看官方网站,将会看到类似的内容

“ GraphQL是API的查询语言,是用于通过使用为数据定义的类型系统执行查询的服务器端运行时。 GraphQL不受任何特定数据库或存储引擎的束缚,而是由您现有的代码和数据提供支持。”

实际上应该说的是

GraphQL是一个规范,仅此而已。

要记住这一点很重要,因为作为开发人员,我们将使用GraphQL的实现。 一些实现已经或多或少地实现了GraphQL规范。 有许多语言的实现,例如JavaScript,Java,PHP,Go和其他语言。 每天都有不同语言和现有语言的新实现。

如果您来自Java背景并且有很多REST API,那么您首先会感兴趣的是GraphQL与您多年来开发的Traditional REST API有何不同。

让我将其放在一个简单的博客的上下文中,该博客由博客文章,博客文章的作者组成,并且可以在博客文章中添加评论。

从数据库的角度来看,这意味着我们有三个表

让我们假设前端是只读的,并从Traditional REST API获取数据,然后将数据呈现给用户。 如果我们要构建这种传统的REST API,则可能最终会得到如下代码

 @RestController  public class SimpleRestController { @RequestMapping (path= "/authors" ) public List getAllAuthors() { ... } @RequestMapping (path= "/authors/{id}" ) public Author getAuthorById( @PathVariable String id) { ... } @RequestMapping (path= "/posts" ) public List getAllPosts( @RequestParam (value= "author_id" , required = false ) String authId) { ... } @RequestMapping (path= "/comments" ) public List getAllComments( @RequestParam (value= "post_id" , required = false ) String postId) { ... }  } 

因此,在这种情况下,如果我们想显示包含作者信息和评论的帖子,我们首先需要致电

  • /帖子

获取所有帖子,然后找到我们想要的帖子,查看authorId是什么,然后调用

  • / authours / <帖子中的ID>

之后,我们需要致电

  • / comments?post_id = <相关帖子的ID>

获取该帖子的所有评论。

显然,这不是最佳方法。 当然,在这种情况下,我们所有人都会做的就是看好API的用例,并牢记这一点来优化端点和响应。 也许我们会将评论嵌入帖子,作者信息或类似内容中。 或者,由于某种原因,如果我们认为没问题,也许我们不会改变任何事情。 无论如何,我们将决定用户可以呼叫哪些端点,以及他们将获得什么样的响应。

确切地说,这是GraphQL的最大区别。 对于GraphQL,通常只有一个端点,例如

  • / graphql

该端点将获取对您的API的所有请求,并发送回所有响应。

起初听起来有点奇怪。 最简单的方法是拥有完整的示例代码。 我将使用一个这样的示例中的代码片段。 要获取完整的代码,只需点击以下URL :https://github.com/vladimir-dejanovic/simple-springboot-graphql-mongo-conftalk-demo

要记住的重要一点是,在GraphQL中,一切都始于模式。 如果我们转到上面的示例,博客文章,GraphQL模式可能看起来像这样:

 type Author { id: ID! name: String! posts: [Post] }  type Post { id: ID! title: String! body: String createdBy: Author! comments: [Comment]  } type Comment { id: ID! createdBy: Author! belongsTo: Post! text: String }  schema { query: Query  }  type Query { allPosts: [Post] allAuthors: [Author]  } 

我们从定义类型开始,对于我们要为表创建的POJO,类型几乎可以是1到1。 首先,我们输入一个名称,然后输入。 字符' '具有特殊含义,表示该字段是必填字段。 如果字段具有此字符并且不存在响应,则它将是无效响应,并且GraphQL将不会将响应发送回去,但会发送适当的错误。

关于模式要记住的重要一点是,所有请求和响应都将使用模式进行验证。 如果请求未通过架构验证,则服务器将不执行任何工作。 同样,如果响应未通过架构验证,则不会将其发送到客户端。

如果您选中“作者”类型,则将看到它具有“帖子数组”类型的字段帖子。 另外,Post具有类型为Author和comments的createdBy字段,其类型为Comment的Array。 这些字段在POJO的中不存在

 Author.java  public class Author {  private final String id;    private final String name;  .....get/set  }  Post.java  public class Post { private final String id;    private String authorId;    private final String title; private final String body;  ...get/set  } 

类似的是注释类型,我稍后会再讲。 定义类型之后,我们可以进入GraphQL模式的核心

 schema { query: Query  } 

这是我们定义与用户互动的地方。 我们说用户可以使用下面定义的Query类型的查询来读取数据。

 type Query { allPosts: [Post] allAuthors: [Author]  } 

Query是一种特殊类型,因为我们在DB中没有此数据,这实际上是传统思维方式中的端点。

如果您是从GitHub链接下载代码,编译并启动的,则可以转到http:// localhost:8080 / 。 然后,您将看到名为GraphiQL的漂亮用户界面。 您可以使用GraphiQL来玩GraphQL API

为了获得所有带有ID,标题和正文的帖子,只需将其输入GraphiQL

 query { allPosts { id title body }  } 

响应应如下所示

 { "data" : { "allPosts" : [ { "id" : "59f4c12e7718af0b1e001072" , "title" : "Who is Ed Wong" , "body" : "Edward Wong Hau Pepelu .....” }, . . . .  } 

例如,如果我们对身体不感兴趣,我们可以输入这样的内容

 query { allPosts { id title }  } 

这样的回应将是这样

 { "data" : { "allPosts" : [ { "id" : "59f4c12e7718af0b1e001072" , "title" : "Who is Ed Wong" , }, . . . .  } 

如您所见,当涉及到GraphQL时,用户在响应中并不总是获得相同的预定义字段集。 用户可以选择说哪些字段应该发回,哪些不应该发回。

允许这样做的Java代码不是那么大。 首先,我们需要定义扩展SimpleGraphQLServlet的 Servlet。

 public class GraphQLEntryPoint extends SimpleGraphQLServlet {    public GraphQLEntryPoint(PostRepository postRepository, AuthorRepository authRepository, CommentRepository commentRepository) { super (buildSchema(postRepository, authRepository, commentRepository)); } private static GraphQLSchema buildSchema(PostRepository postRepository, AuthorRepository authRepository, CommentRepository commentRepository) { return SchemaParser .newParser() .file( "schema.graphqls" ) .resolvers( new Query(postRepository, authRepository), new PostResolver(authRepository, commentRepository), new AuthorResolver(postRepository), new CommentResolver(authRepository, postRepository)) .build() .makeExecutableSchema(); }  } 

在这里,我创建了一个模式解析器,该解析器打开了我的GraphQL模式文件,之后添加了解析器,然后调用build和makeExecutableSchema方法。

这里的重要部分是解析器。 解析器是GraphQL将用于解决用户请求的类。

首先,最重要的是Query类。 它与模式中的Query类型具有相同的名称并非偶然。 这就是java GraphQL实现如何从架构中知道哪个类对应于查询逻辑的方式。 您可以使用任何喜欢的名称,只要该类具有相同的名称即可,但是,这意味着新人们也需要知道该名称,因此请保持标准,并且对于只读使用Query。

这是类查询的代码

 public class Query implements GraphQLRootResolver { private final PostRepository postRepository; private final AuthorRepository authRepo; public List<Post> allPosts() { return postRepository.findAll(); }    public List<Author> allAuthors() { return authRepo.findAll(); }  } 

它实现了GraphQLRootResolver ,如您所见,对于GraphQL模式中的每一行都有一个方法。

有一个叫allPost方法,该方法返回后的名单,也有方法allAuthors返回作者列表。 为了使我们的API能够正常工作,这就是所有这些。

如果您回到GraphiQL并输入像这样的输入

 query { allPosts { id title createdBy { name } }  } 

响应将是这样的

 { "data" : { "allPosts" : [ { "id" : "59f4c12e7718af0b1e001072" , "title" : "Who is Ed Wong" , "createdBy" : { "name" : "Ed Wong” } }, . . . ]  } 

您将获得所有突然的数据作为响应,这不是Post pojo的一部分。 正如我们所看到的,Query类没有任何作用,它只是返回Post类型的纯pojo列表。 那么,createdBy字段的作者信息来自何处?

为此,我们需要查看另一个解析器PostResolver,以使其更加精确,因此让我们看一下它的代码

 public class PostResolver implements GraphQLResolver<Post> {    private final AuthorRepository authRepository; private final CommentRepository commentRepository;    public Author createdBy(Post post) { return authRepository.findOne(post.getAuthorId()); }    public List<Comment> comments(Post post) { return commentRepository.findByPostId(post.getId()); }  } 

PostResolver实现了GraphQLResolver ,我们不得不说是哪种类型,在这种情况下,它是Post的类型 。 如您所见,Post中存在模式中的所有字段,而Pojo Post中不存在。 有一个createdBy方法,该方法采用Post类型的参数并返回Author。

此外,还有方法注释 ,该方法注释也采用Post类型的参数并返回Comment列表。

这就是全部,这就是我在代码中使用的GraphQL的java实现如何知道如何解析pojo中不存在的字段的方式。 在pojo的情况下,这非常简单,如果用户请求该字段,则只需调用适当的get方法,对于其他字段,必须为实现GraphQLResolver的类型提供解析器,并且需要一种具有正确签名和返回类型的方法。

如您所见,与我们一直以来创建的传统REST API相比,使用GraphQL,用户可以更好地控制他/她将获取哪些数据以及采用哪种格式。 因此,从用户的角度来看,这当然具有更好的用户体验,因为它具有更大的灵活性。 但是,这也意味着后端需要完成更多工作,因此系统在高负载下仍然可以正常运行。

在传统的REST API中,我们作为开发人员,在用户与我们的端点进行交互的方式,他们将获得什么样的响应以及用户请求将遵循的路径的完全控制之下,将在我们的代码中进行控制。 如我们所见,使用GraphQL不再是这种情况。 我们知道的是,用户将点击解析器,而不是如何或通过哪个路径。 因此,优化困难得多。

幸运的是,并不是所有的东西都丢失了,我们仍然可以使用许多旧的技巧来解决这些新的/旧的问题。 例如,如果采用传统的REST API,解决高性能问题的一种方法是拥有一个带有端点的控制器,调用服务,然后该服务将承担繁重的工作。 在此设置中,我们可以缓存所有对服务的调用,并以这种简单的方式获得良好的性能。 我们可以使用GraphQL做类似的事情,唯一的不同是控制器将调用服务,而不是控制器调用服务。

使用GraphQL可能会遇到一些棘手的问题,但是,可以结合使用一些过去的技巧来使用过去的许多技术。 当然,每天都会出现许多解决问题的新方法。

我只在这里向您展示了如何读取数据,您当然也可以创建/编辑/修改数据,并使用GraphQL进行更多操作。 当您涉及GraphQL在构建API中提供的功能时,我与您分享的内容只是从头开始。

您需要记住的重要一点是,尽管GraphQL相对较新,但没有它也可以实现它提供的所有功能。 但是,在这种情况下,您将需要考虑允许用户做什么以及他们如何将请求发送到您的API。 对于GraphQL,其他人已经考虑过了,而您所要做的就是实现它。

最后,GraphQL API是REST API,这是高级REST API,具有许多功能和特性,因此更加精确。 这就是为什么问自己的问题,这是一件好事,您是否真的需要GraphQL提供的功能,并且会为您的API和为此API构建域的域增加更多的问题或解决方案。 也许GraphQL正是您所需要的,但也许又是旧的传统REST API所需要的。

资源资源

  • 代码示例https://github.com/vladimir-dejanovic/simple-springboot-graphql-mongo-conftalk-demo
  • GraphQL Java实现https://github.com/graphql-java/graphql-java
  • 弗拉基米尔·德亚诺维奇(Vladimir Dejanovic)在摩洛哥Devoxx上谈论GraphQL与传统REST API的关系https://www.youtube.com/watch?v=2FH93GaoIto

翻译自: https://www.javacodegeeks.com/2017/12/gentle-intro-graphql-java-world.html

java world

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/334285.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

快速排序 动图_Java十大排序算法最强总结

看到一篇很不错的文章&#xff0c;不多说&#xff0c;看吧排序算法说明0.1 排序的定义对一序列对象根据某个关键字进行排序。0.2 术语说明稳定&#xff1a;如果a原本在b前面&#xff0c;而ab&#xff0c;排序之后a仍然在b的前面&#xff1b;不稳定&#xff1a;如果a原本在b的前…

linux安装2870无线网卡,ubuntu15.04安装usb无线网卡

一般这种无线网卡都是联fake芯片&#xff0c;我使用的ralin(你懂的k)的usb无线1150 M。你去找lei凌官网找不到&#xff0c;只能去找芯片类型的制造者&#xff0c;所以只能去联Fake官网查询下载对应型号。1、我是这样子查看型号的&#xff0c;找到通过驱动软件检测并已经安装成功…

Linux 应用程序的源码包如何安装?

文章目录configuremakemake install关于文件 configure 的简单介绍其它命令简介C 语言开发的应用程序的源码包常以 .tar.gz 为扩展名&#xff0c;并且这些源码包通常使用 GNU 的 AUTOCONF 和 AUTOMAKE 生成编译配置文件&#xff0c;我们拿到这样的软件包后&#xff0c;执行下面…

exec su-exec_WildFly Kubernetes exec探针

exec su-exec活动性和就绪性探针会告诉Kubernetes&#xff0c;某个Pod是否正在运行并准备进行一些工作。 企业应用程序可以通过HTTP探测应用程序的状态。 如果没有暴露HTTP端点&#xff0c;Kubernetes也可以通过执行命令进行探测。 WildFly附带了有用的jboss-cli.sh 。 此CLI检…

feignclient注解使用_从 Feign 使用注意点到 RESTFUL 接口设计规范

最近项目中大量使用了Spring Cloud Feign来对接http接口&#xff0c;踩了不少坑&#xff0c;也产生了一些对RESTFUL接口设计的想法&#xff0c;特此一篇记录下。SpringMVC的请求参数绑定机制了解Feign历史的朋友会知道&#xff0c;Feign本身是Netflix的产品&#xff0c;Spring …

Linux 的发行版 Ubuntu 的发展简史

Ubuntu&#xff08;又称乌班图&#xff09;是一个是基于 Debian GNU/Linux 的以桌面应用为主的免费开源的 GNU/Linux 操作系统&#xff0c;由全球化的专业开发团队 Canonical 公司打造的。 Ubuntu Linux 是由南非人马克沙特尔沃思(Mark Shuttleworth)创办的基于 Debian Linux的…

linux实验报告五gcc编译,Linux之GCC命令 -- 解析GCC编译的四个过程

在Linux下进行C语言编程&#xff0c;必然要采用GNU GCC来编译C源代码生成可执行程序。Gcc指令的一般格式为&#xff1a;Gcc [选项] 要编译的文件 [选项] [目标文件]。其中&#xff0c;目标文件可缺省&#xff0c;Gcc默认生成可执行的文件名为&#xff1a;编译文件.out看一下经典…

python创建虚拟环境命令_Python创建虚拟环境报错

我使用命令&#xff1a;mkvirtualenv -p python3 test1,创建虚拟环境&#xff0c;然后报错如下()&#xff0c;虚拟机是用nat模式的: Exception: Traceback (most recent call last): File "/home/python/.virtualenvs/test11/share/python-wheels/urllib3-1.13.1-py2.py3-…

java7和java8切换_切换表达式到Java吗?

java7和java8切换已创建一个标题为“ Java语言的开关表达式”的JEP草案 。 当前的“摘要”状态为&#xff1a;“扩展switch语句&#xff0c;以便可以将其用作语句或表达式&#xff0c;并改善switch处理null的方式。 这些将简化日常编码&#xff0c;并为在switch使用模式匹配做好…

Xenix 操作系统的简史

简介 Xenix 是一种UNIX操作系统&#xff0c;可在个人电脑及微型计算机上使用。该系统由微软公司在1979年从美国电话电报公司获得授权&#xff0c;为Intel处理器所开发。后来&#xff0c;圣克鲁兹作业公司&#xff08;SCO&#xff09;收购了其独家使用权&#xff0c;自那以后&a…

servlet 配置 使用_配置HTTPS以与Servlet一起使用

servlet 配置 使用要配置Java EE应用程序以通过HTTPS进行通信&#xff0c;需要在web.xml文件中使用几行XML。 web.xml文件位于项目的WEB-INF目录中&#xff0c;通常在IDE生成Java EE Web应用程序时自动创建。 如果不是&#xff0c;您可以自己创建它。 HTTPS的动机 为Web应用程…

python写接口测试代码_python写运单接口测试(增改查)完整代码

importrequestsimportjsonfrom urllib importparseclassHttpWayBillRquest:运单的增改查 defaccess_token(self):获取tokenurl http://xxxxxxxxx.comusername 12333password 12334566res_json requests.get(url, auth(username, password)).json()print(access_token的结果为&a…

linux终端cd未找到命令,为什么`which`命令不能用于`cd`?我也找不到`cd`的可执行文件!...

问题描述我尝试了which cd&#xff0c;它没有给出路径&#xff0c;而是返回退出代码1(用echo $?检查)。 coreutil cd本身正在工作&#xff0c;所以可执行文件应该在那里&#xff0c;对吧&#xff1f;我还为cd运行了find&#xff0c;但没有显示可执行文件。那怎么实现呢&#x…

Xenix — 微软与UNIX的短暂爱恋

微软向外宣布Microsoft Xenix OS&#xff0c;一个为16位微处理器开发的可移植的操作系统。它是一个交互的&#xff0c;多用户多任务系统&#xff0c;可以运行在Intel 8086, Zilog Z8000, Motorola M68000以及DEC公司的PDP-11系统计算机上。所有微软已经开发的系统软件&#xff…

optionals_Java Optionals获得更具表现力的代码

optionals我们中任何使用允许空引用的语言进行编程的人&#xff0c;都将在尝试取消引用一个引用时经历过。 无论是导致segfault还是NullPointerException&#xff0c;它始终是一个错误。 托尼霍尔将其描述为他十亿美元的错误 。 当函数向客户端的开发人员未预料到的客户端返回空…

python排序sorted_sorted排序的两个方法 - Python

在给列表排序时&#xff0c;sorted非常好用&#xff0c;语法如下&#xff1a; sorted(iterable[, cmp[,key[,reverse]]]) 简单列表排序&#xff0c;很容易完成&#xff0c;sorted(list)返回的对象就是列表结果&#xff0c;但是遇到列表中嵌套元组时&#xff0c;需要使用特殊的方…

linux vim自动执行快捷键,Linux Vim快捷键操作命令整理

VIM中常用的替换模式总结1&#xff0c;简单替换表达式替换命令可以在全文中用一个单词替换另一个单词&#xff1a;:%s/four/4/g“%” 范围前缀表示在所有行中执行替换。最后的 “g” 标记表示替换行中的所有匹配点。如果仅仅对当前行进行操作&#xff0c;那么只要去掉%即可如果…

Mach 微内核的命名趣闻

据 Tevanian 说&#xff0c;MACH&#xff0c;源于一个读音错误。当时他正和其他人在匹兹堡一个下雨天里一边躲避着路上的泥水坑&#xff0c;一边讨论着新内核的事&#xff0c;Tevanian开玩笑地建议他们的新微核命名为MUCK&#xff0c;意为“多用户通信内核”&#xff08;Multi-…

eclipse占用内存过大_Java性能调优学习(三)-jmap+mat分析内存溢出问题实战

上一节我们讲了jinfo&#xff0c;jstat&#xff0c;jmap的使用&#xff0c;还简单的讲了下如何使用jmap导出内存映像文件&#xff0c;这次&#xff0c;我们来实战一把内存溢出问题。环境准备首先我们先模拟一下内存溢出的场景&#xff0c;以下这段代码在访问后肯定会造成堆内存…

spring boot自测_将测微仪与Spring Boot 2一起使用

spring boot自测这是快速入门&#xff0c;介绍了如何使用出色的Micrometer库来检测基于Spring Boot 2的应用程序并在Prometheus中记录指标 介绍 Micrometer在不同监视工具提供的客户端库上提供了基于Java的外观。 以Prometheus为例&#xff0c;如果我要将Java应用程序与Prome…