GraphQL DGS 框架

清疚 2022-10-31 05:28 175阅读 0赞

netflix 已开放其 Domain Graph Service（DGS）框架的源代码 ，该框架是为了方便整合 GraphQL 使用，用于简化 GraphQL 的实现。  
图片  
GraphQL 主要是作用于数据接口，比如前端后端交互。无需定义或修改后台 Controller、Service 等业务代码即可实现灵活的数据变更，客户端可以自由获取服务端事先定义好的数据，提高了交互接口的灵活性  
组件依赖

graphql-dgs-spring-boot-starter  
  
com.netflix.graphql.dgs  
graphql-dgs-spring-boot-starter  
3.5.1  
  
DGS 必须从 jcenter 下载,不然部分依赖无法下载。踩坑很久  
  
  
  
true  
  
  
  
  
false  
  
central  
bintray  
https://jcenter.bintray.com  
  
  
  
  
  
false  
  
central  
bintray-plugins  
https://jcenter.bintray.com  
  
  
bintray  
  
  
定义接口 schema

/src/main/resources/schema/schema.graphqls  
此文件定义了客户端请求入参格式和查询数据类型  
type Query \{  
shows(title: String ,releaseYear: Int): \[Show\]  
\}

type Show \{  
title: String  
releaseYear: Int  
\}  
定义数据抽取规则

@DgsComponent  
public class ShowsDatafetcher \{

@DgsData(parentType = “Query”, field = “shows”)  
public List shows(@InputArgument(“title”) String title, @InputArgument(“releaseYear”) Integer releaseYear) \{  
if (title == null) \{  
return shows;  
\}

return shows.stream().filter(s -> s.getTitle().contains(title)).collect(Collectors.toList());  
\}

// 模拟 DB 查询

private final List shows = List.of(  
new Show(“java”, 1995),  
new Show(“php”, 1995),  
new Show(“python”, 1990),  
new Show(“golang”, 2009),  
new Show(“rust”, 2015)  
);  
\}

UI 前端调试

访问: http://localhost:8080/graphiql  
图片  
条件查询  
图片  
接口调用

curl --location --request POST ‘http://localhost:8080/graphql’  
–header ‘Content-Type: application/json’  
–data-raw ‘\{“query”:"\{\\n shows(title: “java”, releaseYear: 1995) \{\\n title\\n releaseYear\\n \}\\n\}\\n",“variables”:null\}’  
java 调用

@SpringBootTest(classes = \{DgsAutoConfiguration.class, ShowsDatafetcher.class\})  
class ShowsDatafetcherTests \{

@Autowired  
DgsQueryExecutor dgsQueryExecutor;

@Test  
void shows() \{  
List titles = dgsQueryExecutor.executeAndExtractJsonPath(  
" \{ shows \{ title releaseYear \}\}",  
“data.shows\[\*\].title”);  
assertThat(titles).contains(“java”);  
\}  
\}

本节源码

源码: https://github.com/lltx/dgs-demo  
DGS 官网: https://netflix.github.io/dgs