一、介绍
使用Swagger你只需要按照它的规范去定义接口及接口相关的信息，就可以做到生成接口文档，以及在线接口调试页面。
官网：https://swagger.io/
Knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案。
二、导入依赖
此处导入的是Knife4j，这是一个为MVC框架集成Swagger生成文档的解决方案
三、在配置类中加入 knife4j 相关配置
亲爱的朋友，希望你不要告诉我你不会写配置类，不会配置类的话看文末，最下面有最基础的配置类的教程，保证你能用上最好用的Swagger文档
是在配置类中添加下面内容哦
注意修改里面的一些内容，比如汉字部分以及那个扫描包的路径
这个扫描包的路径切记要修改哦
需要注意的是，这个方法可以设置多个，来使接口文档分页，只要方法名不重复即可
四、设置静态资源映射
设置静态资源映射，否则接口文档页面无法访问
也是在配置类中书写哦
下面这个基本是固定的，不用改，若你想玩一下Swagger的更多玩法，那么你可以去查阅官方文档
五、注意放开拦截器拦截
要注意拦截器拦截，比如如果你设置的有JWT校验，那么就要在配置拦截器那里放开下面这几个静态资源
类似我这样写：
六、使用方式
其实你已经可以使用了，来进入这个页面看一下吧
当你在写配置的时候，需要指定一个扫描路径，它就会自动扫描所有接口，获取对应的数据，构建接口文档
浏览器输入下面这个地址
注意修改ip和端口号为你正在使用的，其他不变
java基础类库的api文档
只不过你会发现它没有备注，当你遇到很麻烦的数据的时候，根本不知道每个属性是干嘛的，这时候就需要使用注解了
利用注解标记Controller和Model层对应的数据，然后利用这些标记的数据自动生成接口文档中对应数据的备注
常用注解
通过注解可以控制生成的接口文档，使接口文档拥有更好的可读性，常用注解如下：
标记数据
现在我对我的login接口进行改造，使其出现在接口文档上
我这里将原来和标记后的代码都进行了展示，主要是看注解，不要看我的逻辑代码，此篇博客只是为了让大家真正上手Swagger的使用
Controller
原来的：
标记后：
可以看到我用@Api标记了UserCroller这个类，用@ApiOperation标记了login这个方法
Model
其实基本项目中的所有Model都要做标记，因为不一定啥时候用到，Model做标记的主要原因是让Swagger知道传来了什么参数(传对象时)，或返回了什么参数
原来的：
标记后：
可以看到，我利用了@ApiModel标记实体类，用@ApiModelProperty标记属性
然后因为我这个项目有一个统一返回的对象Result，所以我对Result也要用注解加个标记
原来的：
标记后：
七、查看演示效果
咱们来发送个请求：
点击调试，可以看到，需要传的参数直接给我们了，多么的方便呀
当时，参数值需要我们填哈哈
来我们再看一个，哪怕传来的是对象，他也应对自如
点击调试，我们只需要填写参数值即可
若你想全部都加上备注，就需要辛苦一下啦
说一个小窍门，丢给GPT，然后修改一下即可哈哈哈
八、设置全局都穿传的参数 —— 例如token
例如我这里
手动先发送个请求，获取登陆后的token
将token添加到“全局参数设置”这里
点击添加参数
这个时候你再发送任何请求，都会自动带上这个全局参数了
教程至此结束，这篇教程更适用于新手，Swagger进阶等我有空了会补充，但这篇博客足以满足大部分学习者了
版权声明：
本文来源网络，所有图片文章版权属于原作者，如有侵权，联系删除。
本文网址：https://www.bianchenghao6.com/h6javajc/25469.html