swagger
官网:https://swagger.io/
1.创建工程导入相关依赖
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>3.0.0</version>
</dependency>
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>3.0.0</version>
</dependency>
2.创建一个经典程序 hello world.
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello(){
return "hello";
}
}
3.启动访问请求,测试成功
4.配置Swagger config
@Configuration
@EnableSwagger2 //开启Swagger
public class SwaggerConfig {
}
5.再次测试访问
在网上搜索了半天解决办法说什么都是guava版本问题,版本必须一直等等,然后在一个评论底下,看到了真正的问题所在。[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传
解决方法:
spring.mvc.pathmatch.matching-strategy= ANT_PATH_MATCHER
原因: 这是因为Springfox使用的路径匹配是基于AntPathMatcher的,而Spring Boot 2.6.X使用的是PathPatternMatcher。 解决: 修改application.yaml
spring: mvc: pathmatch: matching-strategy: ANT_PATH_MATCHER
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/**").addResourceLocations("classpath:/static/");
registry.addResourceHandler("swagger-ui.html")
.addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/");
}
再次测试,依旧404 ,于是我去查看了下路径,也就是wagger-ui下面的路径,是这样的
也就是,处理路径是webjars下面的于是修改为:
registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/springfox-swagger-ui/");
再次启动访问,还是404,我又参考了网上其它教程,也都很简单,就是导入依赖,添加配置文件,测试访问,但是我发现网上资源更新啊迭代的速度就是很慢,他们的以来都是基于2.9.2版本的,这都2022年了,已经是3.x版本了,我搜的时候用的就是最新的,于是我试着回退一下版本,到2.9.2
我又查看了下旧版本的依赖:
在webjars下面有swagger-ui.html,所以旧版的访问直接就是:http://localhost:8888/swagger-ui.html
我又了解了好久,发现新版3.x已经做成了启动器start,只需要一个依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
然后跟我想的一样,查看源码 路径是这样的
然后点进去,看到webmvc中其实也是加入了资源映射路径
新版的访问路径: http://localhost:8888/swagger-ui/
但是并没有怎么学习springboot还是小白,而且是自学,所以再深入已经深入不了了,只能了解到这里了,害,还没学习已经一大堆错误了,害!!!
还有就是查看日志,旧版在日志中直接显示,新版没有!
可能这就是区别,新: