Swagger注解-@SwaggerDefinition

---

Swagger注解-@Api
Swagger注解-@ApiOperation
Swagger注解-@ApiImplicitParams 和 @ApiImplicitParam
Swagger注解-@ApiModel 和 @ApiModelProperty
Swagger注解-@ApiResponses 和 @ApiResponse
Swagger注解-@ResponseHeader
Swagger注解-@ApiParam
Swagger注解-@Authorization 和 @AuthorizationScope
Swagger注解-@SwaggerDefinition
Swagger注解-@ExternalDocs
Springboot 集成 Swagger GitHub 地址

---

使用场景

定义 metadata level 时使用，在 Rest 接口或类上使用

概述

配置定义 metadata level的注解。仍然缺少 Security Requirements，Parameters，Responses

属性

属性名称	数据类型	默认值	说明
host	String	“”	要在生成的Swagger定义中指定的主机
basePath	String	“”	指定生成的Swagger文档定义basePath
consumes	String[]	“”	***
produces	String[]	“”	***
schemes	Scheme[]	Scheme.DEFAULT	API 的传输协议
tags	Tag[]	@Tag(name = “”)	可用于标记单个Apis和ApiOperations的全局标记
securityDefinition	SecurityDefinition	@SecurityDefinition()	安全方案的定义
info	Info	@Info(title = “”, version = “”)	为swagger定义常规元数据
externalDocs	ExternalDocs	@ExternalDocs(url = “”)	外部文档

---

Swagger注解-@Api
Swagger注解-@ApiOperation
Swagger注解-@ApiImplicitParams 和 @ApiImplicitParam
Swagger注解-@ApiModel 和 @ApiModelProperty
Swagger注解-@ApiResponses 和 @ApiResponse
Swagger注解-@ResponseHeader
Swagger注解-@ApiParam
Swagger注解-@Authorization 和 @AuthorizationScope
Swagger注解-@SwaggerDefinition
Swagger注解-@ExternalDocs
Springboot 集成 Swagger GitHub 地址

---