欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Spring boot 2.1.0 -- swagger2 整合

程序员文章站 2024-01-25 09:07:04
依赖版本信息 Spring boot 2.1.0.RELEASE swagger2 2.7.0 1- mvn 配置 pom.xml 包引入 1 2 3 io.springfox 4
依赖版本信息
spring boot 2.1.0.release
swagger2 2.7.0
1- mvn 配置  pom.xml 包引入
 1 <!--swagger2依赖-->
 2 <dependency>
 3 <groupid>io.springfox</groupid>
 4 <artifactid>springfox-swagger2</artifactid>
 5 <version>2.7.0</version>
 6 </dependency>
 7 <dependency>
 8 <groupid>io.springfox</groupid>
 9 <artifactid>springfox-swagger-ui</artifactid>
10 <version>2.7.0</version>
11 </dependency>
12 <!--swagger2美化插件依赖-->
13 <dependency>
14 <groupid>com.github.xiaoymin</groupid>
15 <artifactid>swagger-bootstrap-ui</artifactid>
16 <version>1.6</version>
17 </dependency>
2-配置config
在application.java同级目录创建 swagger2config.java 内容
Spring boot 2.1.0 -- swagger2 整合
 1 package com.muyuer.springdemo;
 2 
 3 import org.springframework.context.annotation.bean;
 4 import org.springframework.context.annotation.configuration;
 5 import springfox.documentation.builders.apiinfobuilder;
 6 import springfox.documentation.builders.pathselectors;
 7 import springfox.documentation.builders.requesthandlerselectors;
 8 import springfox.documentation.service.apiinfo;
 9 import springfox.documentation.spi.documentationtype;
10 import springfox.documentation.spring.web.plugins.docket;
11 import springfox.documentation.swagger2.annotations.enableswagger2;
12 
13 @configuration
14 @enableswagger2
15 public class swagger2config {
16 
17     @bean
18     public docket createrestapi() {
19         return new docket(documentationtype.swagger_2)
20                 .apiinfo(apiinfo())
21                 .select()
22                 .apis(requesthandlerselectors.basepackage("com.muyuer.springdemo.controller"))
23                 .paths(pathselectors.any())
24                 .build();
25     }
26 
27     private apiinfo apiinfo() {
28         return new apiinfobuilder()
29                 .title("xx项目 restful apis")
30                 .description("xx项目后台api接口文档")
31                 .version("1.0")
32                 .build();
33     }
34 
35 }
3-遇到的问题
开始使用其它版本swagger出现过以下错误 
{"code":404,"message":"接口 [/swagger-ui.html] 不存在"}
网上搭建答案是
添加 webmvcconfigurer.java内容如下 
//swagger2配置
@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/");
}

自己实际测试添加了这些代码并未生效

重新建了项目引用上面版本的spring boot 2.1.0.release swagger2 2.7.0包后即成功了。