前言:
Swagger
what?
前后端接口测试工具
Swagger 能够生成一个在线的接口文档,可以看到文档中的接口有什么功能、里面需要传递哪些参数、返回的数据,方便测试接口。
why?
前后端分离的情况下,后端只需要向前端提供接口即可。那么重点就是接口的传参和返回值。
在软件开发的生命周期中,文档是非常重要的,所以也有戏称软件学院就是写文档的(x)。在实际开发中,如果存在开发人员没有及时更新接口文档、信息有误等问题,就很麻烦。
而swagger可以在项目中通过注解形成文档;更新及时;能在先对接口进行测试;无需手动传输文件,直接url访问。
how?
在SwaggerConfig中的docker里面可以自定义接口展示,还可以生成多个docker进行分组来实现接口文档的一致性。
参考:https://cloud.tencent.com/developer/article/1772882
https://blog.csdn.net/YyjYsj/article/details/113788709
1、配置swagger并进入localhost:8080/doc.html找到测试接口
昨天找了一晚上都不知道若依里swagger怎么配置的,网上教程很多不是在若依系统上做的,有点乱,最后看了官方文档,轻松解决(其实很简单,一把辛酸泪)
Q: 访问localhost:8080/doc.html后只有test-controller
检索:
解决:(网上乱七八糟的教程看的心累,急于解决问题的同时容易忽视细节)
解决了!待测试的接口出现了!
2、测试接口
随便找一个请求,查看请求头中的内容,获取里面的token,复制下面这一块的内容。
参考:https://blog.csdn.net/Keep__Me/article/details/133878687
推荐使用chrome进行查看authorizationfangwen
Q: 报404
检查:在之前写好的前端界面查看调用路径
查看报错的路径
解决:路径写错了,将dev-api去掉,这是前端统一访问的baseURL,可以看day2的笔记。
参考:https://www.imooc.com/qadetail/303309
正式进入swagger测试
(1)查询所有商品详情
请求头部就是上面提到的authorization
响应
对应的数据库表如下图所示。
(2)根据id删除商品
(3)查询某个商品详情
(4)新增
Q:
检查:在之前写好的前端界面上查找该方法的调用路径
解决:改路径
(5)修改
解决:不从前端界面的调用路径来检查,也可以从代码中发现根本问题
水平有限,如有错误,敬请指正。