1.pom文件
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
</dependency>
2.放在config目录下的两个文件
Swagger2Configuration.java
@Configuration
@EnableSwagger2
public class Swagger2Configuration {
@Bean
public Docket ApiConfig(){
return new Docket(DocumentationType.SWAGGER_2)
.groupName("Api")
.apiInfo(ApiInfo())
.select()
//只显示api路径下的页面
.apis(RequestHandlerSelectors.basePackage("com.wdy"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo ApiInfo(){
return new ApiInfoBuilder()
.title("应急组织的-API文档")
.description("本文档描述了应急组织的接口")
.version("1.0")
.build();
}
}
WebMvcConfigurer.java
@Configuration
public class WebMvcConfigurer extends WebMvcConfigurerAdapter {
/**
* 访问静态资源
* */
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
/**
* SpringBoot自动配置本身并不会把/swagger-ui.html
* 这个路径映射到对应的目录META-INF/resources/下面
* 采用WebMvcConfigurerAdapter将swagger的静态文件进行发布;
*/
registry.addResourceHandler("swagger-ui.html")
.addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/");
//将所有/static/** 访问都映射到classpath:/static/ 目录下
registry.addResourceHandler("/static/**").addResourceLocations(ResourceUtils.CLASSPATH_URL_PREFIX +"/static/");
super.addResourceHandlers(registry);
}
}
3.运行
http://localhost:8080/swagger-ui.html
4.代码中有些字段需要根据实际的项目包名改变