SpringBoot集成Graphql Query實戰(zhàn)示例
概述
REST作為一種現(xiàn)代網(wǎng)絡(luò)應(yīng)用非常流行的軟件架構(gòu)風格受到廣大WEB開發(fā)者的喜愛，在目前軟件架構(gòu)設(shè)計模式中隨處可見REST的身影，但是隨著REST的流行與發(fā)展，它的一個最大的缺點開始暴露出來：
在很多時候客戶端需要的數(shù)據(jù)往往在不同的地方具有相似性，但卻又不盡相同。
如同樣的用戶信息，在有的場景下前端只需要用戶的簡要信息（名稱、頭像），在其他場景下又需要用戶的詳細信息。當這樣的相似但又不同的地方多的時候，就需要開發(fā)更多的接口來滿足前端的需要。
隨著這樣的場景越來越多，接口越來越多，文檔越來越臃腫，前后端溝通成本呈指數(shù)增加。
基于上面的場景，我們迫切需要有一種解決方案或框架，可以使得在使用同一個領(lǐng)域模型（DO、DTO）的數(shù)據(jù)接口時可以由前端指定需要的接口字段，而后端根據(jù)前端的需求自動適配并返回對應(yīng)的字段。
這就是我們今天的主角GraphQL。
場景模擬
考慮下面的場景：
用戶 與 文章 是一對多的關(guān)系，一個用戶可以發(fā)表多篇文章，同時又可以根據(jù)文章找到對應(yīng)的作者。
我們需要構(gòu)建以下幾個Graphql查詢：
- 根據(jù)用戶ID獲取用戶詳情，并獲取此用戶發(fā)表的所有文章
- 根據(jù)文章ID獲取文章詳情，并獲取文章作者的信息
當然項目是基于SpringBoot開發(fā)的。
開發(fā)實戰(zhàn)
在正式開發(fā)之前我推薦你在IDEA上安裝一下 JS GraphQL插件，這個插件方便我們編寫Schema，語法糾錯，代碼高亮等等。。。
創(chuàng)建一個SpringBoot項目
通過IDEA創(chuàng)建一個SpringBoot項目，并引入對應(yīng)的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目錄下創(chuàng)建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關(guān)鍵字定義了兩個對象，User與Post。在屬性后面添加！表明這是一個非空屬性，通過[Post]表明這是一個Post集合，類似于Java對象中List。
通過Query關(guān)鍵字定義了兩個查詢對象，getUserById，getPostById，分別返回User對象和Post對象。
關(guān)于schema的語法大家可以參考鏈接：https://graphql.org/learn/schema/
編寫業(yè)務(wù)邏輯
PostService
@Service
public class PostService implements GraphQLQueryResolver {
/**
* 為了測試，只查詢id為1的結(jié)果
*/
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的查詢需要實現(xiàn)GraphQLQueryResolver接口，由于為了便于演示我們并沒有引入數(shù)據(jù)層，請大家知悉。
配置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即可添加對應(yīng)的查詢。
點擊Send Request 即可看到查詢結(jié)果：
然后我們在Query中可以根據(jù)我們的需要新增或刪除接口字段并重新請求接口，會看到響應(yīng)結(jié)果中也會根據(jù)我們的請求自動返回結(jié)果：
小結(jié)
Graphql支持的數(shù)據(jù)操作有：
- 查詢（Query） ：獲取數(shù)據(jù)的基本查詢。
- 變更（Mutation） ：支持對數(shù)據(jù)的增刪改等操作。
- 訂閱（Subscription） ：用于監(jiān)聽數(shù)據(jù)變動、并靠websocket等協(xié)議推送變動的消息給對方。
本節(jié)內(nèi)容我們基于SpringBoot完成了Query的數(shù)據(jù)操作，實現(xiàn)過程還是相對比較簡單。希望此文能讓大家對Graphql有一個整體的了解，如果大家對Graphql感興趣后面還會更新此系列文章，完成對其他數(shù)據(jù)操作的整合。
更多關(guān)于SpringBoot集成Graphql Query的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
給@Value設(shè)置默認值以及為static變量賦值問題
在Spring框架中,@Value注解用于屬性注入,可將配置文件中的值賦給變量,未指定默認值時,若配置文件缺少相應(yīng)屬性,程序啟動會報錯,可通過設(shè)定默認值防止此問題,對于靜態(tài)變量,由于@Value無法直接注入,需通過Set方法賦值,該方法也支持默認值設(shè)置2024-09-09
java實現(xiàn)excel和txt文件互轉(zhuǎn)
本篇文章主要介紹了java實現(xiàn)excel和txt文件互轉(zhuǎn)的相關(guān)知識。具有很好的參考價值。下面跟著小編一起來看下吧2017-04-04
這篇文章主要介紹了Java異常處理中finally子句的運用,是Java入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下2015-09-09
Java實現(xiàn)學(xué)生信息管理系統(tǒng)(借助Array?List)
這篇文章主要為大家詳細介紹了Java實現(xiàn)學(xué)生信息管理系統(tǒng),借助Array?List，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-01-01
本文主要介紹Java 失效的private修飾符，這里整理了相關(guān)資料說明private 修飾符的作用，如何使用并與C++ 做比較，有興趣的小伙伴可以參考下2016-08-08
Springboot?Filter中注入bean無效為null問題
這篇文章主要介紹了Springboot?Filter中注入bean無效為null問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-05-05
在最初學(xué)習(xí)java的時候，人們都知道，java這種面向?qū)ο蟮恼Z言，一共有三大特征，分別是：封裝、繼承、多態(tài)。多態(tài)的實現(xiàn)途徑有三種：重寫、重載、接口實現(xiàn)。本文就來為大家詳細講講Java方法的重載與重寫2022-07-07
AsyncConfigurerSupport自定義異步線程池處理異常
這篇文章主要為大家介紹了AsyncConfigurerSupport自定義異步線程池處理異常詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-06-06
Mybatis-Plus之ID自動增長的設(shè)置實現(xiàn)
本文主要介紹了Mybatis-Plus之ID自動增長的設(shè)置實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-07-07
這篇文章主要介紹了Java中正則表達式split()特殊符號使用詳解， 文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-07-07