springboot集成swagger3.0.0

经过了近两年，swagger终于再次更新，2.x最新版已经更新到2.10.5，并且推出了3.x版本的第一个版本3.0.0，支持springboot直接集成springfox-boot-starter。

springboot集成最新的swagger3.0.0版本，只需要一个maven依赖包就行：

<!-- swagger -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

然后增加配置文件，自定义swagger ui的文档说明：

package com.molicloud.robot.config;

import io.swagger.annotations.ApiOperation;
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;

@Configuration
public class Swagger2Config {

    public static final String VERSION = "1.0.0";

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("茉莉机器人接口")
                .description("机器人后台请求接口")
                .contact(new Contact("茉莉机器人", "", "chatbot@itpk.cn"))
                .version(VERSION)
                .build();
    }

}

swagger3.x可以不需要添加@EnableSwagger2这个注解，其他的使用注解并无变化，可参考之前的写法，3.0.0官方发布地址：https://github.com/springfox/springfox/releases/tag/3.0.0

未经允许不得转载：小茉莉 » springboot集成swagger3.0.0