Spring Boot 整合 swagger2 自动生成 RESTFul API 文档

Posted 1x11

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Spring Boot 整合 swagger2 自动生成 RESTFul API 文档相关的知识,希望对你有一定的参考价值。

1)首先编辑pom.xml添加依赖

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.9.2</version>
</dependency>

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
  <version>2.9.2</version>
</dependency>

 

2)创建Swagger配置文件

package pro.kkpai.springbootswagger.config;

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 SwaggerConfig {

    @Bean
    public Docket RestApi(){
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("pro.kkpai.springbootswagger.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                //标题
                .title("这是Swagger的RESTFul API")
                //描述
                .description("一个用户管理系统的RESTFul API")
                //联系方式
                .contact(new Contact("kkpai", "https://kkpai.pro", "[email protected]"))
                //服务条款url
                .termsOfServiceUrl("https://kkpai.pro")
          
//版本 .version("1.0") .build(); } }

 3)Controller层类添加注解

  @Api

 

未完。。。

 


以上是关于Spring Boot 整合 swagger2 自动生成 RESTFul API 文档的主要内容,如果未能解决你的问题,请参考以下文章

Spring Boot整合Swagger2构建RESTful API

Spring Boot 整合 swagger2 自动生成 RESTFul API 文档

Spring Boot2 系列教程(十七)SpringBoot 整合 Swagger2

Spring Boot2 系列教程(十七)SpringBoot 整合 Swagger2

SpringBoot之整合Swagger2

SpringBoot整合--Swagger2