SpringBoot集成GraphqlQuery實戰(zhàn)示例

第SpringBoot集成GraphqlQuery實戰(zhàn)示例目錄概述場景模擬開發(fā)實戰(zhàn)創(chuàng)建一個SpringBoot項目建立Java實體類編寫Schema文件編寫業(yè)務邏輯配置Graphql端點測試安裝插件查詢小結(jié)

概述

REST作為一種現(xiàn)代網(wǎng)絡應用非常流行的軟件架構(gòu)風格受到廣大WEB開發(fā)者的喜愛，在目前軟件架構(gòu)設計模式中隨處可見REST的身影，但是隨著REST的流行與發(fā)展，它的一個最大的缺點開始暴露出來：

在很多時候客戶端需要的數(shù)據(jù)往往在不同的地方具有相似性，但卻又不盡相同。

如同樣的用戶信息，在有的場景下前端只需要用戶的簡要信息（名稱、頭像），在其他場景下又需要用戶的詳細信息。當這樣的相似但又不同的地方多的時候，就需要開發(fā)更多的接口來滿足前端的需要。

隨著這樣的場景越來越多，接口越來越多，文檔越來越臃腫，前后端溝通成本呈指數(shù)增加。

基于上面的場景，我們迫切需要有一種解決方案或框架，可以使得在使用同一個領(lǐng)域模型（DO、DTO）的數(shù)據(jù)接口時可以由前端指定需要的接口字段，而后端根據(jù)前端的需求自動適配并返回對應的字段。

這就是我們今天的主角GraphQL。

場景模擬

考慮下面的場景：

用戶與文章是一對多的關(guān)系，一個用戶可以發(fā)表多篇文章，同時又可以根據(jù)文章找到對應的作者。

我們需要構(gòu)建以下幾個Graphql查詢：

根據(jù)用戶ID獲取用戶詳情，并獲取此用戶發(fā)表的所有文章根據(jù)文章ID獲取文章詳情，并獲取文章作者的信息

當然項目是基于SpringBoot開發(fā)的。

開發(fā)實戰(zhàn)

在正式開發(fā)之前我推薦你在IDEA上安裝一下JSGraphQL插件，這個插件方便我們編寫Schema，語法糾錯，代碼高亮等等。。。

創(chuàng)建一個SpringBoot項目

通過IDEA創(chuàng)建一個SpringBoot項目，并引入對應的jar

dependencies

dependency

groupIdorg.springframework.boot/groupId

artifactIdspring-boot-starter/artifactId

/dependency

dependency

groupIdorg.springframework.boot/groupId

artifactIdspring-boot-starter-web/artifactId

/dependency

!--graphqlstart--

dependency

groupIdcom.graphql-java/groupId

artifactIdgraphql-spring-boot-starter/artifactId

version5.0.2/version

/dependency

dependency

groupIdcom.graphql-java/groupId

artifactIdgraphql-java-tools/artifactId

version5.2.4/version

/dependency

!--graphqlend--

dependency

groupIdjectlombok/groupId

artifactIdlombok/artifactId

/dependency

/dependencies

這里主要需要引入graphql-spring-boot-starter和graphql-java-tools。

建立Java實體類

User

@Data

publicclassUser{

privateintuserId;

privateStringuserName;

privateStringrealName;

privateStringemail;

privateListPostposts;

publicUser(){

publicUser(intuserId,StringuserName,StringrealName,Stringemail){

this.userId=userId;

this.userName=userName;

this.realName=realName;

this.email=email;

Post

@Data

publicclassPost{

privateintpostId;

privateStringtitle;

privateStringtext;

privateStringcategory;

privateUseruser;

publicPost(){

publicPost(intpostId,Stringtitle,Stringtext,Stringcategory){

this.postId=postId;

this.title=title;

this.text=text;

this.category=category;

定義了兩個JAVA實體：Post，User。

編寫Schema文件

在resources/schema目錄下創(chuàng)建GraphQLSchema文件

schema{

query:Query,

typeQuery{

#獲取具體的用戶

getUserById(id:Int):User

#獲取具體的博客

getPostById(id:Int):Post

typeUser{

userId:ID!,

userName:String,

realName:String,

email:String,

posts:[Post],

typePost{

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的語法大家可以參考鏈接：/learn/schema/

編寫業(yè)務邏輯

PostService

@Service

publicclassPostServiceimplementsGraphQLQueryResolver{

*為了測試，只查詢id為1的結(jié)果

publicPostgetPostById(intid){

if(id==1){

Useruser=newUser(1,"javadaily","JAVA日知錄","zhangsan@");

Postpost=newPost(1,"Hello,Graphql","Graphql初體驗","日記");

post.setUser(user);

returnpost;

}else{

returnnull;

UserService

@Service

publicclassUserServiceimplementsGraphQLQueryResolver{

ListUseruserList=Lists.newArrayList();

publicUsergetUserById(intid){

returnuserList.stream().filter(item-item.getUserId()==id).findAny().orElse(null);

@PostConstruct

publicvoidinitUsers(){

Postpost1=newPost(1,"Hello,Graphql1","Graphql初體驗1","日記");

Postpost2=newPost(2,"Hello,Graphql2","Graphql初體驗2","日記");

Postpost3=newPost(3,"Hello,Graphql3","Graphql初體驗3","日記");

ListPostposts=Lists.newArrayList(post1,post2,post3);

Useruser1=newUser(1,"zhangsan","張三","zhangsan@");

Useruser2=newUser(2,"lisi","李四","lisi@");

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瀏覽器的AltairGraphalClient插件，當然你還可以使用其他的客戶端工具，如：graphql-playground。

安裝插件

瀏覽器輸入chrome://extensions/，在擴展中心搜索Altair后即可添加至瀏覽器。

查詢

啟動SpringBoot項目，然后在打開的Altair插件界面，輸入Graphql端點http://localhost:8080/graphql，然后點擊Docs，將鼠標移至需要的查詢上，點擊ADDQUERY即可添加對應的查詢。

點擊SendRequest即可看到查詢結(jié)果：

然后我們在Query中可以根據(jù)我們的需要新增或刪除接口字段并重新請求接口，會看到響應結(jié)果中也會根據(jù)我們的請求自動返回結(jié)果：

小結(jié)

Graphql支持的數(shù)據(jù)操作有：

查詢（Query）：獲取