189 8069 5689
这篇文章将为大家详细讲解有关spring boot中怎么整合swagger-ui，文章内容质量较高，因此小编分享给大家做个参考，希望大家阅读完这篇文章后对相关知识有一定的了解。
创新互联服务项目包括纳雍网站建设、纳雍网站制作、纳雍网页制作以及纳雍网络营销策划等。多年来，我们专注于互联网行业，利用自身积累的技术优势、行业经验、深度合作伙伴关系等，向广大中小型企业、政府机构等提供互联网行业的解决方案，纳雍网站推广取得了明显的社会效益与经济效益。目前，我们服务的客户以成都为中心已经辐射到纳雍省份的部分城市，未来相信会继续扩大服务区域并继续获得客户的支持与信任！1.添加mvn依赖
修改pom.xml加入
io.springfox springfox-swagger2 2.5.0 io.springfox springfox-swagger-ui 2.5.0
2.创建配置类
在Application.java同级创建Swagger2的配置类Swagger2
package com.tydt.decision;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
@Configuration
@EnableSwagger2
public class Swagger2{
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.tydt.decision.controller"))
.paths(PathSelectors.any()).build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder().title("Decision Manage Swagger RESTful APIs")
.description("Decision API")
.termsOfServiceUrl("http://swagger.io/")
.contact(new Contact("Beibei", "127.0.0.1", "XXXXXXX@qq.com"))
.version("1.0")
.build();
}
}注：
如果出现下面情况
引入需要的包
但是启动时又出现Error creating bean with name 'apiDocumentationScanner' defined in URL
这是由于swagger依赖google的guava，需要添加依赖，而当前项目的guava版本与之不匹配，修改为
com.google.guava guava 15.0
http://localhost:8090/swagger-ui.html页面没显示
这是因为Spring Boot自动配置本身不会自动把/swagger-ui.html这个路径映射到对应的目录META-INF/resources/下面。加上这个映射即可
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
……
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("swagger-ui.html")
.addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/");
}
}解决了上面出现的问题，访问http://localhost:8090/swagger-ui.html就能看到下面的页面了
说明：
（1）通过@Configuration注解，让Spring来加载该类配置
（2）再通过@EnableSwagger2注解来启用Swagger2
（3）通过createRestApi函数创建Docket的Bean之后，apiInfo()用来创建该Api的基本信息
（4）select()函数返回一个ApiSelectorBuilder实例用来控制哪些接口暴露给Swagger来展现
（5）指定扫描的包路径来定义，会扫描该包下所有Controller定义的API，并产生文档内容，除了用@ApiIgnore指定的
（6）通过@ApiOperation注解来给API增加说明
（7）通过@ApiImplicitParams
（8）@ApiImplicitParam注解来给参数增加说明
关于spring boot中怎么整合swagger-ui就分享到这里了，希望以上内容可以对大家有一定的帮助，可以学到更多知识。如果觉得文章不错，可以把它分享出去让更多的人看到。
另外有需要云服务器可以了解下创新互联建站www.cdcxhl.com，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。