前言
swagger是一个流行的API开发框架,这个框架以“开放API声明”(OpenAPI Specification,OAS)为基础,对整个API的开发周期都提供了相应的解决方案,是一个非常庞大的项目(包括设计、编码和测试,几乎支持所有语言)。
OAS本身是一个API规范,它用于描述一整套API接口,包括一个接口是GET还是POST请求啊,有哪些参数哪些header啊,都会被包括在这个文件中。它在设计的时候通常是YAML格式,这种格式书写起来比较方便,而在网络中传输时又会以json形式居多,因为json的通用性比较强。
由于Spring的流行,Marty Pitt编写了一个基于Spring的组件swagger-springmvc,用于将swagger集成到springmvc中来。而springfox则是从这个组件发展而来,同时springfox也是一个新的项目。
一. 依赖
1 <!--swagger--> 2 <!-- https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter --> 3 <dependency> 4 <groupId>io.springfox</groupId> 5 <artifactId>springfox-boot-starter</artifactId> 6 <version>3.0.0</version> 7 </dependency>
二. 问题所在(解决)
按照之前的swagger依赖来看,正常的 地址应该是 localhost:8080/swagger-ui.html
但是集成后倒入这个依赖,发现跳转 404,说明出现问题了,去找源码发现 集成的 依赖更改了地址,源码和两种方式如图
默认地址: localhost:8080/swagger-ui/ 或者 localhost:8080/swagger-ui/index.html