SpringBoot开发秘籍 - 集成Graphql Query

概述

REST做为一种现代网络应用很是流行的软件架构风格受到广大WEB开发者的喜好，在目前软件架构设计模式中随处可见REST的身影，可是随着REST的流行与发展，它的一个最大的缺点开始暴露出来：前端

在不少时候客户端须要的数据每每在不一样的地方具备类似性，但却又不尽相同。
如一样的用户信息，在有的场景下前端只须要用户的简要信息（名称、头像），在其余场景下又须要用户的详细信息。当这样的类似但又不一样的地方多的时候，就须要开发更多的接口来知足前端的须要。java

随着这样的场景愈来愈多，接口愈来愈多，文档愈来愈臃肿，先后端沟通成本呈指数增长。web

基于上面的场景，咱们迫切须要有一种解决方案或框架，可使得在使用同一个领域模型（DO、DTO）的数据接口时能够由前端指定须要的接口字段，然后端根据前端的需求自动适配并返回对应的字段。spring

这就是咱们今天的主角GraphQL。chrome

场景模拟

考虑下面的场景：后端

用户与文章是一对多的关系，一个用户能够发表多篇文章，同时又能够根据文章找到对应的做者。设计模式

咱们须要构建如下几个Graphql查询：浏览器

根据用户ID获取用户详情，并获取此用户发表的全部文章微信
根据文章ID获取文章详情，并获取文章做者的信息websocket

固然项目是基于SpringBoot开发的。

开发实战

在正式开发以前我推荐你在IDEA上安装一下 JS GraphQL插件，这个插件方便咱们编写Schema，语法纠错，代码高亮等等。。。

建立一个SpringBoot项目

经过IDEA建立一个SpringBoot项目，并引入对应的jar

<dependencies>
 <dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter</artifactId>
 </dependency>

 <dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-web</artifactId>
 </dependency>

 <!--graphql start-->
 <dependency>
  <groupId>com.graphql-java</groupId>
  <artifactId>graphql-spring-boot-starter</artifactId>
  <version>5.0.2</version>
 </dependency>
 <dependency>
  <groupId>com.graphql-java</groupId>
  <artifactId>graphql-java-tools</artifactId>
  <version>5.2.4</version>
 </dependency>
 <!--graphql end-->

 <dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok</artifactId>
 </dependency>
</dependencies>

这里主要须要引入 graphql-spring-boot-starter和 graphql-java-tools。

创建Java实体类

User

@Data
public class User {
    private int userId;
    private String userName;
    private String realName;
    private String email;
    private List<Post> posts;

    public User() {
    }

    public User(int userId, String userName, String realName, String email) {
        this.userId = userId;
        this.userName = userName;
        this.realName = realName;
        this.email = email;
    }
}

Post

@Data
public class Post {
    private int postId;
    private String title ;
    private String text;
    private String  category;
    private User user;

    public Post() {

    }

    public Post(int postId, String title, String text, String category) {
        this.postId = postId;
        this.title = title;
        this.text = text;
        this.category = category;
    }

}

定义了两个JAVA实体：Post，User。

编写Schema文件

在resources/schema目录下建立GraphQL Schema文件

schema {
    query: Query,
}

type Query {
    # 获取具体的用户
    getUserById(id:Int) : User
    # 获取具体的博客
    getPostById(id:Int) : Post
}

type User {
    userId : ID!,
    userName : String,
    realName : String,
    email : String,
    posts : [Post],
}

type Post {
    postId : ID!,
    title : String!,
    text : String,
    category: String
    user: User,
}

如上，咱们经过 type关键字定义了两个对象，User与Post。在属性后面添加！代表这是一个非空属性，经过[Post]代表这是一个Post集合，相似于Java对象中List。

经过Query关键字定义了两个查询对象，getUserById，getPostById，分别返回User对象和Post对象。

关于schema的语法你们能够参考连接：https://graphql.org/learn/schema

编写业务逻辑

PostService

@Service
public class PostService implements GraphQLQueryResolver {
    /**      * 为了测试，只查询id为1的结果      */
    public Post getPostById(int id){
        if(id == 1){
            User user = new User(1,"javadaily","JAVA日知录","zhangsan@qq.com");
            Post post = new Post(1,"Hello,Graphql","Graphql初体验","日记");
            post.setUser(user);
            return post;
        }else{
            return null;
        }

    }
}

UserService

@Service
public class UserService implements GraphQLQueryResolver {
    List<User> userList = Lists.newArrayList();

    public User getUserById(int id){
        return userList.stream().filter(item -> item.getUserId() == id).findAny().orElse(null);
    }


    @PostConstruct
    public void  initUsers(){
        Post post1 = new Post(1,"Hello,Graphql1","Graphql初体验1","日记");
        Post post2 = new Post(2,"Hello,Graphql2","Graphql初体验2","日记");
        Post post3 = new Post(3,"Hello,Graphql3","Graphql初体验3","日记");
        List<Post> posts = Lists.newArrayList(post1,post2,post3);

        User user1 = new User(1,"zhangsan","张三","zhangsan@qq.com");
        User user2 = new User(2,"lisi","李四","lisi@qq.com");

        user1.setPosts(posts);
        user2.setPosts(posts);


        userList.add(user1);
        userList.add(user2);

    }

}

基于Graphql的查询须要实现 GraphQLQueryResolver接口，因为为了便于演示咱们并无引入数据层，请你们知悉。

配置Graphql 端点

server.port = 8080
graphql.servlet.corsEnabled=true
# 配置端点
graphql.servlet.mapping=/graphql
graphql.servlet.enabled=true

配置完端口和端点后咱们就能够对咱们编写的Graphql接口进行测试了。

接口地址为：localhost:8080/graphql

测试

这里我使用的是Chrome浏览器的 Altair Graphal Client插件，固然你还可使用其余的客户端工具，如：graphql-playground。

安装插件

浏览器输入chrome://extensions/，在扩展中心搜索Altair后便可添加至浏览器。

查询

启动SpringBoot项目，而后在打开的Altair插件界面，输入Graphql端点 http://localhost:8080/graphql，而后点击 Docs，将鼠标移至须要的查询上，点击 ADD QUERY 便可添加对应的查询。

点击Send Request 便可看到查询结果：

而后咱们在Query中能够根据咱们的须要新增或删除接口字段并从新请求接口，会看到响应结果中也会根据咱们的请求自动返回结果：

小结

Graphql支持的数据操做有：

查询（Query）：获取数据的基本查询。
变动（Mutation）：支持对数据的增删改等操做。
订阅（Subscription）：用于监听数据变更、并靠websocket等协议推送变更的消息给对方。

本节内容咱们基于SpringBoot完成了Query的数据操做，实现过程仍是相对比较简单。但愿此文能让你们对Graphql有一个总体的了解，若是你们对Graphql感兴趣后面还会更新此系列文章，完成对其余数据操做的整合。

以上，但愿对你有所帮助！

本文分享自微信公众号 - JAVA日知录（javadaily）。
若有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一块儿分享。