将Ruoyi框架系统的Swagger接口文档页面优化为knife4j风格

将Swagger文档原来的页面效果改成比较好看的knife4j风格文档页面

优化前:

请求地址:http://localhost:端口号/swagger-ui/index.html

优化后:

请求地址:http://localhost:端口号/doc.html#/home

修改步骤:

1.引入依赖(新增以下依赖)

<dependency>
	<groupId>com.github.xiaoymin</groupId>
	<artifactId>knife4j-spring-boot-starter</artifactId>
	<version>2.0.9</version>
</dependency>

2.修改SecurityConfig.java文件的filterChain()方法,放行doc.html文件

3.修改SwaggerConfig.java文件的createRestApi()方法,将DocumentationType.OAS_30改成DocumentationType.SWAGGER_2

4.重新启动项目,请求doc.html文档地址,http://localhost:端口号/doc.html#/home

小问题:

请求如果出现:404不要慌,不就是请求页面不存在么,小问题,查看请求发现请求路径多了/dev-api,把Swagger配置的请求前缀去掉就可以了

操作:

全局配置文件这注释pathMapping是没有用的

注释SwaggerConfig文件的路径配置代码,重启项目即可

可以明显看到前缀/dev-api没有了

其他

1.还可以在前端配置后端请求的地址上加上/dev-api这样子前后端的请求都一样了,也不会报错

2.也可以试试全局配置文件里边把pathMapping的值去掉,不配置值(/dev-api)试试,不保证成功啊,这里就不一一去尝试了

猜你喜欢

转载自blog.csdn.net/qq_53376718/article/details/142139004