1.引入依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.8.0</version>
</dependency>
2.swagger配置文件
@Configuration
@EnableSwagger2
public class Swagger2Config {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
// 自行修改为自己的包路径
.apis(RequestHandlerSelectors.basePackage("com.ysk.mybatiscrack"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("swagger-api文档")
.description("swagger接入教程")
//服务条款网址
.termsOfServiceUrl("https://blog.csdn.net/ysk_xh_521")
.version("1.0")
.contact(new Contact("Y.S.K", "http://ysk521.cn", "1176971130@qq.com"))
.build();
}
}
3.controller注解配置
注意:
在整合Swagger时访问默认的路径:http://localhost:8080/swagger-ui.html,出现404问题,根据查看,发现是相关资源被拦截了,于是配置下就好了
@Configuration
public class WebConfig implements WebMvcConfigurer {
/**
* 解决swagger被拦截的问题
* @param registry
*/
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("swagger-ui.html")
.addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/");
}
}