Java实战开发之swagger配置及访问

今天来讲讲swagger

目录

一、swagger简介及主要特点

二、swagger的配置



一、swagger简介及主要特点

Swagger 是一个流行的开源框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。它可以让开发者和用户更方便地理解和使用 API。Swagger 通过定义 RESTful API 的规范(使用 YAML 或 JSON 格式)来实现这些功能。这些规范称为 OpenAPI 规范(之前称为 Swagger 规范)。

Swagger 的主要特点包括:

  1. 自动生成 API 文档:通过分析代码中的注解,Swagger 自动生成清晰、易读的 API 文档,包括 API 的路径、参数、响应等详细信息。

  2. 交互式 API 文档:Swagger 提供了一个 Web 界面(Swagger UI),允许用户直接在浏览器中测试 API,无需编写任何代码。这使得开发者和用户能够快速了解 API 的工作原理和使用方法。

  3. 支持多种语言:Swagger 支持多种编程语言,如 Java、Python、Ruby、JavaScript 等,使得开发者可以根据自己的技能和需求选择合适的语言来开发 API。

  4. 社区支持:Swagger 拥有庞大的开发者社区,提供了丰富的资源和插件,以支持不同的框架和工具。这使得开发者可以轻松地将 Swagger 集成到现有的项目中。

  5. API 版本管理:Swagger 允许开发者在同一项目中维护多个 API 版本,方便对 API 进行迭代和更新。

二、swagger的配置

首先需要两个依赖

如果你使用的是springboot3的话

那么就只能使用以下的依赖:

XML 复制代码
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>2.1.0</version>
        </dependency>

        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
            <version>2.1.0</version>
        </dependency>

这样才不会发生冲突

另外,springboot3的swagger不用在启动类上添加任何注解

也不用更改yml或者properties文件的任何配置即可使用

最后访问http://127.0.0.1:port/contextPath/swagger-ui/index.html

如果你是 springboot2的话建议使用如下配置

XML 复制代码
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

一个依赖即可

并在启动类上添加@EnableOpenApi注解

最后访问http://127.0.0.1:port/contextPath/swagger-ui.html

相关推荐
惜.己7 分钟前
使用python的读取xml文件,简单的处理成元组数组
xml·开发语言·python·测试工具
Shimiy20 分钟前
第六章 面向对象编程------进阶
java
大葱白菜25 分钟前
Java Set 集合详解:从基础语法到实战应用,彻底掌握去重与唯一性集合
java·后端
大葱白菜26 分钟前
Java Map 集合详解:从基础语法到实战应用,彻底掌握键值对数据结构
java·后端
添乱26 分钟前
「Java案例」判断是否是闰年的方法
java
FG.30 分钟前
Day22
java·面试
apihz31 分钟前
域名WHOIS信息查询免费API使用指南
android·开发语言·数据库·网络协议·tcp/ip
菜鸟的迷茫32 分钟前
Redis 缓存雪崩、穿透、击穿面试题深度解析与 Spring Boot 实战代码示例
java
珹洺43 分钟前
C++算法竞赛篇:DevC++ 如何进行debug调试
java·c++·算法
coding随想44 分钟前
掌控网页的魔法之书:JavaScript DOM的奇幻之旅
开发语言·javascript·ecmascript