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

相关推荐
Coding小公仔10 分钟前
C++ bitset 模板类
开发语言·c++
KK溜了溜了18 分钟前
JAVA-springboot 整合Redis
java·spring boot·redis
小赖同学啊27 分钟前
物联网数据安全区块链服务
开发语言·python·区块链
天河归来28 分钟前
使用idea创建springboot单体项目
java·spring boot·intellij-idea
shimly12345634 分钟前
bash 脚本比较 100 个程序运行时间,精确到毫秒,脚本
开发语言·chrome·bash
weixin_478689761 小时前
十大排序算法汇总
java·算法·排序算法
码荼1 小时前
学习开发之hashmap
java·python·学习·哈希算法·个人开发·小白学开发·不花钱不花时间crud
IT_10241 小时前
Spring Boot项目开发实战销售管理系统——数据库设计!
java·开发语言·数据库·spring boot·后端·oracle
new_zhou2 小时前
Windows qt打包编译好的程序
开发语言·windows·qt·打包程序