Springboot3学习(4、Swagger使用及配置)

Springboot3学习——Swagger3使用(四)

0、Swagger介绍

‌Swagger是一个用于描述、设计和文档化RESTful Web服务的规范。它允许以清晰、可理解的方式定义API,并提供工具来生成API文档、客户端SDK、服务器端存根等。Swagger3强调对RESTful API的支持和规范化,提供了更丰富和灵活的定义方式‌。我们主要使用其生成API文档,以及在界面测试API接口的功能

1、pom.xml添加springdoc-openapi-starter-webmvc-ui依赖

<dependency>
   	<groupId>org.springdoc</groupId>
   	<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
   	<version>2.3.0</version>
   </dependency>

2、运行成功,如下图

image-20241017141813941

大功告成!

ps:题外话,在配置Swagger的过程中,走了不少弯路,分享给大家

关于依赖,最终用了springdoc-openapi-starter-webmvc-ui,但是在网上刚开始查找的时候,还有其他依赖springfox-swagger2springfox-swagger-ui这两个是一组的,还有springfox-boot-starter,还有springdoc-openapi-ui,但是最后都尝试失败了,页面显示资源不存在。

image-20241017142813032

包括最后,添加依赖springdoc-openapi-starter-webmvc-ui,依然显示上诉错误,最后做了如下操作,终于显示成功了。清楚了无效缓存(猜测可能是之前引入了swagger2,操作了一堆导致了问题)

image-20241017142935896

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值