Swagger如何在SpringBoot中使用

這篇文章給大家介紹Swagger如何在SpringBoot中使用，內容非常詳細，感興趣的小伙伴們可以參考借鑒，希望對大家能有所幫助。

依賴

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

配置類

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;

/**
 * Swagger的配置類
 * @author 陳加兵
 *
 */
@Configuration
public class SwaggerConfig{
 /**
 * 創建用戶API文檔
 * @return
 */
 @Bean
 public Docket createRestUserApi(){
 return new Docket(DocumentationType.SWAGGER_2)
 .groupName("user") 
 .apiInfo(apiInfo()) //api的信息
 .select()
 .apis(RequestHandlerSelectors
  .basePackage("cn.tedu.mycat.controller")) //添加包掃描
 .paths(PathSelectors.any()).build();

 }

 /**
 * 創建API信息
 */
 private ApiInfo apiInfo(){
 return new ApiInfoBuilder()
 .title("api文檔的標題") //標題
 .description("api文檔的描述") //描述
 .contact( //添加開發者的一些信息
  new Contact("愛撒謊的男孩", "https://chenjiabing666.github.io",
  "18796327106@163.com")).version("1.0").build();
 }

}

啟動類

在springBoot的啟動類上添加一個注解即可配置成功： @EnableSwagger2

訪問api的路徑
http://ip/projectName/swagger-ui.html

注解說明

@Api

• 標注在類上，用來對這個類進行說明的

• 如果想要生成文檔，必須在類或者接口上標注

• 屬性如下：

@ApiOperation

• 用在API方法上，對該API做注釋，說明API的作用

• 不需要多講，看源碼，使用默認的value屬性即可，說明該方法的作用

• 屬性如下：

@ApiImplicitParams

• 用來包含API的一組參數注解，可以簡單的理解為參數注解的集合聲明

• 很重要，這個注解其中包含接口入參的詳細說明

• 內容是集合
  

@ApiImplicitParam

用在 @ApiImplicitParams 注解中，也可以單獨使用，說明一個請求參數的各個方面

詳細的屬性使用說明如下：

• name ：屬性的字段名稱，相當于form表單中的name，這個就是入參的字段

• dataType ：參數的類型，標識，字符串

• value ：該參數的描述

• required ：是否必填，布爾值

• defaultValue ：缺省值，會在文檔中缺省填入，這樣更方面造數據，不需要調用接口的去填值了

• paramType ：指定參數的入參數方式（也就是請求參數的位置），其中有四種常用的，如下：

• query

• path

• body

• form

paramType屬性的詳細說明

• query ：必須要和入參的字段一樣，也可以使用 @RequestParam() 指定

• path ：用于Restful的風格的url，請求的參數寫在路徑上，如下：

@ApiOperation(value="根據用戶Id獲取用戶信息",response=User.class,hidden=false)
 @ApiImplicitParams({
 @ApiImplicitParam(paramType = "path", name = "id", dataType="Integer", required = false, value = "用戶的id", defaultValue = "1")
 })
 @GetMapping("/user/get/{id}")
 public Object getUser(@PathVariable("id")Integer id){
 return new User(id, "陳加兵");
 }

• body：以流的形式提交 僅支持POST
   form：以表單的形式提交
  

關于Swagger如何在SpringBoot中使用就分享到這里了，希望以上內容可以對大家有一定的幫助，可以學到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。