Swagger3

参考https://blog.csdn.net/YXXXYX/article/details/124952856 https://blog.csdn.net/m0_53157173/article/details/119454044 不加会报错 访问http://localhost:8080/swagger-ui/index.html Docket 是一个配置类，用于配置 Swagger 的文档生成规则。通过创建一个 Docket 实例，您可以指定要生成的文档的详细信息，例如 API 的基

→ springboot 集成 Swagger2 ← 这次直接使用 2.5.6 的 spring-boot 。 依赖： 启动类加注解 @EnableOpenApi 新建测试类 访问 http://127.0.0.1:8080/swagger-ui.html ，没错，又是 Error 页面 此部分参考：https://blog.csdn.net/mmmm0584/article/details/117786055 在swagger3.0中，swagger-ui.html的位置发生了变化：   

         SpringCloud项目中，微服务模块和网关模块必不可少。按照以前SpringBoot的模式，单个服务拥有自己的Api文档（Swagger文档），引入微服务后，多文档管理成了一个问题。我们需要一个统一的入口方便前端同学查看。本篇文章就是把各个微服务的swagger-api文档，集成到网

开发时经常会出现下面这种情况——“不熟”的接口 因为业务的需要接口文档可能会发生改变，前后端交互上经常会出现参数不符的情况，通过Excel或者Word维护接口文档，会存在时效性较差的问题，而Swagger正是解决这一痛点的利器。在代码中加入注解，可以实时更新接口。

swagger官网：传送门 swagger是一个Api框架，就是一个工具，就比如我们可以使用postman测试接口一样，swagger主要作用是生成RESTFUL接口的文档并且可以提供功能测试； 通过swagger可以获取项目的api结果，生成清晰的api文档，并可以进行一些自动化测试 Swagger-tools:提供各种与Swagger进

          Swagger 3是一种开源的API描述工具，它可以帮助开发人员设计、构建、文档化和测试API。Swagger 3支持多种编程语言和框架，包括Java、Node.js、Python、Ruby等，并提供了许多集成工具和插件，例如Postman、Apigee等。 Swagger 3使用OpenAPI规范来描述API，这是一种通用的API描述

打开Swagger页面，效果如下： 右边多了一把锁的标志，点击就可以输出token值。 点击Authorize之后，发送的请求都会自动在请求头中加上字段为token，值为输入值。 参考连接：springdoc-openapi-ui添加一个JWT请求头参数以生成swagger 注意到初始化安全策略时Type可以选择多种： 上例使

目录 一、Swagger2完整用法 1.POM依赖 2.接口类 3.实现类 4.托管静态资源 5.接口文档配置 6.生产环境关闭接口文档 7.Swagger3页面效果 二、Swagger3完整用法 三、Swagger整合Knife4jUi 1.POM依赖 2.接口类 3.实现类 4.托管静态资源 5.接口文档配置 6.生产环境关闭接口文档 四、注释和参数讲解

一、Maven配置 注意swagger的版本号是3.0.0版本以上才可以，这里我们就选择3.0.0版本  完整的Maven配置如下（仅供参考）： 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 http://maven.apache.org/xsd/maven-4.0.0.xsd\\\"

Swagger2（基于openApi3）已经在17年停止维护了，取而代之的是 sagger3（基于openApi3），而国内几乎没有 sagger3使用的文档，百度搜出来的大部分都是swagger2的使用，这篇文章将介绍如何在 java 中使用 openApi3（swagger3）。 Open API OpenApi是业界真正的 api 文档标准，其是由 Swagger 来维护

欢迎来到我的小天地，这里是我记录技术点滴、分享学习心得的地方。📚 🛠️ 技能清单 编程语言 ：Java、C、C++、Python、Go、 前端技术 ：Jquery、Vue.js、React、uni-app、Echarts UI设计 : Element-ui、Antd、Color-ui 后端技术 ：Spring Boot、Mybatis-plus、Swagger 移动开发 ：Android 操作系统 ：

   Swagger是一个根据代码注解生成接口文档的工具，减少和前端之间的沟通，前端同学看着文档就可以开发了，提升了效率，之前很少写swagger，这次自己动手写，还是有点麻烦，不怎么懂，记录下，避免下次继续踩坑         新建一个springboo项目，一路next就好，这里使用的