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

赞 (0) 打赏

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

觉得文章有用就打赏一下小茉莉

支付宝扫一扫打赏

微信扫一扫打赏