knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案,前身是swagger-bootstrap-ui,取名knife4j是希望它能像一把匕首一样小巧,轻量,并且功能强悍!
目前,一般都使用knife4j框架,集成方式参考链接:链接
父工程zzyl/pom.xml
3.0.3
版本锁定依赖,在父工程添加
com.github.xiaoymin
knife4j-spring-boot-starter
${knife4j.version}
zzyl-common/pom.xml
com.github.xiaoymin
knife4j-spring-boot-starter
前端修改: 将路径修改为doc.html
重启前后端工程,实现后的效果(内部使用)
外部使用:http://localhost:8080/doc.html#/home
● 可以设置全局参数
由于若依中的所有接口都已经做了安全校验,在访问之前,我们必须设置一个全局参数来获取到登录之后的token才可以正常访问,不然会报一个401错误
解决:
当我们正常登录系统之后,就可以在后端获取一个jwt生成的token,这个token是登录成功的标识,后期其他请求都需要携带这个token才能正常访问
我们可以在浏览器中打开F12,查看网络,当登录成功后可以查看返回的token
有了token以后,就可以把这个token设置到全局参数中
● key=Authorization
● value=请求头token信息
● 可以下载离线文档
● 提供了更好的接口文档阅读界面
● 提供了更方便的接口测试