运行swagger 发现swagger 嵌套在页面里
查看文档
查看前端的代理,包一层
直接打开对应的后端API地址,即可
http://localhost:8080/swagger-ui/index.html
401 认证失败无法访问
如果出现了这个错误,观察request url 和前端相比前缀多加了/dev-api
查看后端swagger配置
把相应的坑去掉!!
Swagger常用注解使用详解
引用文章
http://c.biancheng.net/view/5533.html
https://zhuanlan.zhihu.com/p/98075551
@Api:放在请求的类上,与 @Controller 并列,说明类的作用,如用户模块,订单类等。
tags="说明该类的作用"
value="该参数没什么意义,所以不需要配置"
3.8.1版本里面TestController 写法失效
@Api("学生信息管理")
使用下面写法正常显示
@Api(tags={"学生信息管理"})
@ApiOperation:"用在请求的方法上,说明方法的作用"
value="说明方法的作用"
notes="方法的备注说明"
@ApiOperation("获取学生信息列表")
@ApiModel("学生类")
public class StgStudent extends BaseEntity
{
private static final long serialVersionUID = 1L;
/** 学生id */
@ApiModelProperty(value = "学生id")
private Long studentId;