Spring Boot + GraphQL 才是 API 的未来!

使用 Java 与 Spring Boot 实现高效 GraphQL API 开发 使用 Spring Boot 和 GraphQL,可以快速搭建强大的 API 服务,其灵活的查询机制能更好地满足现代前端开发需求。通过结合 GraphQL 的批量数据处理、分页、实时订阅和高效性能优化,Java 开发者可以大幅提升服务的开发效率和性能。赶快试试,将 GraphQL 引入到你的 Java 项目中吧! 阅读详情

点击上方“芋道源码”,选择“设为星标”

管她前浪,还是后浪?

能浪的浪,才是好浪!

每天 10:33 更新文章,每天掉亿点点头发...

源码精品专栏

 

来源:blog.youkuaiyun.com/x763795151/
article/details/117604505

b3b1f7b61e818bfab55b2f099b2bca93.png


前言

在浅尝GraphQL一文描述了GraphQL及基本使用,本文提供一个基本示例,描述如何基于spring boot的web项目快速应用。

graphql-java的官方文档:Getting started with GraphQL Java and Spring Boot,提供了相关依赖用以快速配置,但是个人真心不建议使用这个库及相关配置方式来搭建脚手架,在实际开发中,业务比较复杂的时候,会导致需要配置的业务代码比较多也比较繁琐,相对下面这种方式,代码复杂性比较高。

本文提供一种更灵活快捷的方式,在spring boot项目中快速应用开发。使用的依赖也和上面官方提供的都不一样,请注意区分。

推荐下自己做的 Spring Boot 的实战项目:

https://github.com/YunaiV/ruoyi-vue-pro

快速开始

创建spring boot工程

通过Spring Initializr快速搭建,我选的jdk版本及spring boot版本,如下所示,其它版本未做兼容性测试。

f4feec0780cf0bb776d727730554fbf4.png

点击下方的Generate按钮:

f90e94580bc3cf89bcbe9329dd73fa50.png

打开工程结构如下,我将application.properties删除了替换成applicaiton.yml,因为我个人比较喜欢yaml的配置方式:

0317a01b2ecd776ac448df67be32c0b8.png

引入相关依赖

pom.xml配置如下:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>2.4.6</version>
  <relativePath/> <!-- lookup parent from repository -->
 </parent>
 <groupId>com.xuxd</groupId>
 <artifactId>graphql.demo</artifactId>
 <version>0.0.1-SNAPSHOT</version>
 <name>graphql.demo</name>
 <description>GraphQL Demo project for Spring Boot</description>
 <properties>
  <java.version>1.8</java.version>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  <lombok.version>1.18.20</lombok.version>
  <graphql-java-tools.version>11.0.1</graphql-java-tools.version>
  <gson.version>2.8.7</gson.version>
 </properties>
 <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>
 
  <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-test</artifactId>
   <scope>test</scope>
  </dependency>
 
  <dependency>
   <groupId>org.projectlombok</groupId>
   <artifactId>lombok</artifactId>
   <version>${lombok.version}</version>
   <scope>provided</scope>
  </dependency>
 
  <dependency>
   <groupId>com.graphql-java-kickstart</groupId>
   <artifactId>graphql-java-tools</artifactId>
   <version>${graphql-java-tools.version}</version>
  </dependency>
 
  <dependency>
   <groupId>com.google.code.gson</groupId>
   <artifactId>gson</artifactId>
   <version>${gson.version}</version>
  </dependency>
 </dependencies>
 
 <build>
  <plugins>
   <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
   </plugin>
  </plugins>
 </build>
 
</project>

初始化GraphQL实例

我们将创建一个GraphQL实例并将其注册到spring容器中,代码如下:

创建一个GraphQLProvider类:

@Component
public class GraphQLProvider {
 
    private GraphQL graphQL;
 
    @Autowired
    private IItemService itemService;
 
    @Bean
    public GraphQL graphQL() {
        return graphQL;
    }
 
    @PostConstruct
    public void init() throws IOException {
        GraphQLSchema graphQLSchema = SchemaParser.newParser()
            .file("graphql/base.graphqls")
            .resolvers(new Query(), new Mutation())
            .file("graphql/item.graphqls")
            .resolvers(new ItemResolver(itemService))
//            .file("book.graphqls")
//            .resolvers(new BookResolver())  //其它定义照上面的示例,继续增加
            .build().makeExecutableSchema();
 
        this.graphQL = graphQL.newGraphQL(graphQLSchema).build();
    }
 
}

关于*.graphqls或者对应的Resolver如ItemResolver,可以参看浅尝GraphQL相关描述,这里只是作了微调整,相关代码如下:

base.grqphqls

schema {
    # 查询
    query: Query
    # 更新
    mutation: Mutation
}
 
type Query {
    version: String
}
 
type Mutation {
    version: String
}

item.graphqls

> 推荐下自己做的 Spring Cloud 的实战项目:
>
> <https://github.com/YunaiV/onemall>

# 定义一个查询类型
extend type Query {
    queryItemList: ItemList  # 定义查询项目列表
    queryById(id: ID): Item
}
 
extend type Mutation {
    updateName(param: Param): Item
}
 
# 定义项目字段
type Item {
    id: ID!
    code: String!
    name: String!
}
 
type ItemList {
    itemList: [Item!]!  #获取项目列表
    total: Int!      # 获取项目总数
}
 
input Param {
    id: ID!
    name: String!
}

ItemResolver

public class ItemResolver implements GraphQLQueryResolver, GraphQLMutationResolver {
 
    private IItemService itemService;
 
    public ItemResolver(IItemService itemService) {
        this.itemService = itemService;
    }
 
    // 对应item.graphqls里的queryItemList
    public ItemList queryItemList() {
        return itemService.queryItemList();
    }
 
    public Item queryById(Long id) {
        return itemService.queryById(id);
    }
 
    public Item updateName(Param param) {
        return itemService.updateName(param);
    }
}

相关业务代码比较多,就不一一贴了。

提供API

我们需要暴露一个接口来接收请求,并作相关处理,也只需提供一个接口即可。因此我们创建一个Controller:GraphqlController.

@RestController
@RequestMapping("/graphql")
@Log
public class GraphqlController {
 
    @Autowired
    private GraphQL graphQL;
 
    @PostMapping
    public Object execute(@RequestBody GraphqlRequest request) {
        ExecutionInput executionInput = ExecutionInput.newExecutionInput()
            .query(request.getQuery())
            .variables(request.getVariables())
            .build();
        Map<String, Object> result = new HashMap<>();
 
        ExecutionResult executionResult = graphQL.execute(executionInput);
        List<GraphQLError> errors = executionResult.getErrors();
 
        if (errors != null && !errors.isEmpty()) {
            result.put("errors", errors);
            return result;
        }
        return executionResult.getData();
    }
}

到这一步,其实基本功能都已配置完成,可以启动项目进行相关测试了。

整个项目的代码结构如下,我尽量用了一个比较常规的web项目结构(controller,service,dao等):

171514bc3bae1aeeb0416889e5f1e65c.png

测试

示例中总共提供了3个接口,两个查询一个更新,分别进行测试:

ItemList queryItemList();
 
Item queryById(Long id);
 
Item updateName(Param param);

查询所有项目列表(只获取每个项目的编码和名称,以及列表总数):

d43c3d991a9dead9aea71db9707b4457.png

根据ID查询,获取项目的id和名称

d9d66b6834de5891d860454a1ed78557.png

更新指定ID的项目名称

我们项目Id为1编码为test的项目修改为“java项目”

c075bf833c66e297f25ef468109aa929.png

再查询一下,可以看到结果更新了:

60326402e44014fc7b661e202ec926b2.png

结束语

这样整个项目的GraphQL相关的基本配置已经完成,可以进行业务开发了。

关于示例的完整代码,我提交到了github,感兴趣可以下载下来看下,地址:

https://github.com/xxd763795151/graphql.demo



欢迎加入我的知识星球,一起探讨架构,交流源码。加入方式,长按下方二维码噢:

0161df0f6ec4a74dfe1086fe0a41552d.png

已在知识星球更新源码解析如下:

43ecb633ffcb1125080b819454640527.png

a8dafaed740ea9d90d20a644a2a3466b.png

af3b1cbae4b0d8fbb4a106b9f4119e5b.png

78e81782e9c77a09b5c7c8b077285cb3.png

最近更新《芋道 SpringBoot 2.X 入门》系列,已经 101 余篇,覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。

提供近 3W 行代码的 SpringBoot 示例,以及超 4W 行代码的电商微服务项目。

获取方式:点“在看”,关注公众号并回复 666 领取,更多内容陆续奉上。

文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
使用Spring Boot实现GraphQL 开发环境 Windows10 Java 11(采用OpenJDK jdk11.0.4+11 OpenJ9 0.15.1) Maven 3.5.4 STS 4.4.0 阅读详情

相关推荐

Spring Boot 与 GraphQL:打造高效、灵活的API架构!

🏆本文收录于《滚雪球学Spring Boot》,专门攻坚指数提升,2025 年国内最系统+最强(更新中)。    本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容,🚀均为全网独家首发,打造精品专栏,专栏持续更新中…欢迎大家订阅持续学习。 如果想快速定位学习,可以看这篇【SpringBoot教程导航帖】,你想学习的都被收集在内,快速投入学习!!两不误。

**My Coding Family** 1284

GraphQL基础知识与Spring for GraphQL使用教程

GraphQL基础知识与Spring for GraphQL使用教程。GraphQL是一种用于API开发的查询语言和运行时环境。它由Facebook开发并于2015年开源。GraphQL的主要目标是提供一种更高效、灵活和易于使用的方式来获取和操作数据。与传统的RESTful API相比,GraphQL允许客户端精确地指定需要的数据,并减少了不必要的网络传输和数据处理。

penngo的专栏 3589

graphql-java-demo:基于Spring Boot Starter的GraphQL Java演示

GraphQL演示服务 #TL; TR 执行start.sh脚本以通过compose生成并启动容器。 一旦开始,您就可以通过 , GraphiQL或Altair对GraphQL进行实验 ./start.sh 介绍 此存储库包含一个简单的Spring Boot(2.x)服务,该服务实现了GraphQL API。 该实现基于受Apollo启发的GraphQL Java库graphql-java-tools。 graphql-java-common -GraphQL实现,它是GraphQL的模式优先实现。 graphql-spring-boot -GraphQL的Sprinb引导启动器。 Spring Boot 2.x 应用 该应用程序在JPA存储库的顶部实现GraphQL。 该应用程序提供了以下基本功能:存储会议,为会议提供一组对话,为每个对话提供一组发言人。 并可以为每个Talk

构建基于Spring Cloud和GraphQL的API网关

构建基于Spring Cloud和GraphQL的API网关 大家好,我是微赚淘客系统3.0的小编,是个冬天不穿秋裤,天冷也要风度的程序猿! 随着微服务架构的普及,API网关作为系统的入口点和微服务之间的“门面”,扮演着重要角色。本文将介绍如何利用Spring Cloud和GraphQL构建一个高效的API网关,实现统一的...

weixin_40329981的博客 171

matlab2021a版本条件下安装spm

SPM (Statistical Parametric Mapping),中文名叫统计参数映射。统计参数映射是指构建和评估空间扩展的统计过程,用于测试关于功能成像数据的假设。这些想法已经在名为SPM的免费开源软件中得到了实例化。SPM软件包用于脑成像数据序列分析。目前的版本可以分析fMRI, PET, SPECT, EEG和MEG。 可能由于matlab版本更新的问题,按照之前教程所写的安装方法会出现错误,踩了一些坑,但好在最终解决了。。。 1、下载链接,如下 SPM12 Software -...

qq_42356925的博客 8407

Spring Cloud + MyBatis Plus + GraphQL 完整示例

GraphQL 集成springcloud 和mybatisPlus 实现增删改查(CRUD)

天雨流芳 937

彻底解决Win11锁屏界面黑屏或者图片不变化

windows锁屏后黑屏

renkai721的专栏 1万+

springboot实现graphql

springboot实现graphql

weixin_41463944的博客 800

华为云计算——FusionCompute创建虚拟机

华为云计算——FusionCompute创建虚拟机

jks212454的博客 3682

反应动力学仿真软件:Kintecus_(12).高级功能与技巧

Kintecus允许用户自定义复杂的反应方程,包括非线性反应和多相反应。通过自定义反应方程,用户可以更准确地描述实际反应系统。多尺度仿真是指在同一模型中同时考虑不同时间和空间尺度的反应过程。Kintecus提供了工具来处理从微观分子动力学到宏观反应动力学的多尺度仿真。通过本节的学习,您已经掌握了Kintecus的高级功能与技巧,包括复杂反应网络的构建、参数优化与敏感性分析、自定义反应机制、多尺度仿真、并行计算与批处理,以及数据可视化与后处理。

kkchenjj的博客 1049

Spring Boot 3 + GraphQL: 快速上手指南与实战经验

SringBoot3整合GraphQL编写现代化API接口

qq_44974763的博客 2840

微信小程序 - 实现人脸识别对比+人脸相似度数据,用户从相册选择或拍照上传两张图片进行人脸对比得到人脸相似度及判断是否是同一个人,微信小程序检测人脸相似度(免费纯前端方案+调用第三方API接口方案)

微信小程序实现人脸识别对比,微信小程序人脸对比 人脸对比识别 人脸对比相似度,实现获取手机摄像头权限,调用相机拍照实现人脸识别相似度对比,小程序人脸相似度对比,快速识别两张照片的相似程度(用百分比)图片相似度对比在线测试,图片相似度对比,微信小程序人脸相似度对比分析,计算两张人脸的相似度,从而判断是否同一个人,并给出相似度评分。小程序如何实现人脸相似度比对,小程序纯前端怎么对比两张图片的相似度,计算两幅图像的相似度,图像相似度对比方法,调用百度AI的人脸识别,微信小程序中实现人脸识别认证,实现人脸检测、人脸

🏆 前端领域优质创作者 4865

Java工具14-Java构建GraphQL API:使用Spring Boot全面指南

本文介绍了使用Spring Boot构建GraphQL API的完整指南。GraphQL作为一种灵活的查询语言,相比REST API具有按需获取数据、减少网络请求等优势。文章从核心概念讲起,对比了GraphQL与REST的差异,并详细说明了Spring Boot整合GraphQL所需的技术栈和Maven依赖配置。主要内容包括环境准备、项目初始化,为后续构建生产级GraphQL API打下基础。

千淘万漉虽辛苦,吹尽狂沙始到金 2万+

性能调优秘籍——让OpenClaw运行速度提升10倍(2026优化版)

OpenClaw性能优化核心摘要 本文详细介绍了提升OpenClaw系统性能的关键技术,包括: 使用性能分析器进行代码级性能诊断 内存优化与高效缓存策略 并发处理优化技术 数据库查询性能提升方法 重点内容包括: 全面的性能分析工具实现(计时、内存监控、错误跟踪) 自动生成性能报告和优化建议 操作耗时与内存占用分析算法 关键性能指标(平均耗时、内存增长)计算 通过系统性的性能分析优化,可使OpenClaw运行速度提升10倍以上。

博客 904

教程: 将 SolidWorks 设计导出为 ROS 的 URDF

请按照以下步骤应用自定义徽标纹理:创建徽标材质文件:techniquepass材质名称:测试/材质颜色属性:环境、漫反射、镜面和发射都设置为白色(1 1 1 1),这意味着该材质看起来完全是白色的。纹理 在表面应用纹理图像 logo.png。将材质文件复制到 gazebo matrial:复制徽标图像:将 “徽标 ”替换为机器人上徽标所在位置的适当参考值。按照以上步骤,您就可以在 Gazebo 中为机器人添加自定义材质和纹理,包括徽标。

机器人控制与仿真应用 2462
上一篇: 微服务拆分原则之AKF
下一篇: Docker 从入门到精通(建议收藏的教程)
公众号-芋道源码
博客等级 码龄10年 1640粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值