博客

最近试了试swagger接口文档，swagger版本3.0.0。以为和以前的低版本的swagger使用方法一致，可是启动过程中出现了各种问题（启动失败，访问失败），网上找了一圈各种解决方案都没有在本机生效，只有自己研究研究了。

其实高版本和低版本的不同只体现在引入pom和配置类使用的注解上

pom文件：

<!--  spring-boot-starter-parent 2.2.2.RELEASE  -->
<dependencies>
    <!-- swagger 3.0.0 -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-boot-starter</artifactId>
        <version>3.0.0</version>
    </dependency>
    
	<!--  低版本的swagger  -->
    <!--<dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-common</artifactId>
        <version>2.9.2</version>
    </dependency>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.9.2</version>
    </dependency>-->
</dependencies>

配置类：

@Configuration
//@EnableSwagger2  // 老版本开启swagger
//@EnableOpenApi   // 网上搜到的解决报错添加的
public class SwaggerConfig {

    @Bean
    public Docket createRestApi1() {
        ApiInfo apiInfo = new ApiInfoBuilder()
                .title("我的接口文档")
                .contact(new Contact("mySwagger", "heheheh", "hello@163.com"))
                .version("1.0")
                .description("接口文档描述")
                .build();

        //docket对象用于封装接口文档相关信息
        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo)
                .groupName("用户接口组")
                .select()
                .apis(RequestHandlerSelectors.basePackage("cn.xf.swagger.controller"))
                .build();
        return docket;
    }
}

启动项目，访问swagger，访问地址：localhost:端口号/swagger-ui