Swagger注解-@SwaggerDefinition

秒速五厘米 2022-02-14 06:15 469阅读 0赞

# 使用场景 #

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

# 概述 #

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

# 属性 #

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

发表评论取消回复

表情：

评论列表（有 0 条评论，469人围观）

还没有评论，来说两句吧...

相关阅读

相关 SWAGGER注解说明

@ApiModelProperty:对象属性,用在出入参数对象的字段上 @Api:用于controller类上 @ApiOperation:用在controller的方法上

旧城等待，/ 2024年03月31日 16:55/ 0 赞/ 107 阅读

相关 swagger注解。

类注解 @Api（类注解） value > > 表示类的链接地址，访问此类的URL中需要加/，必填。 > > > > des

曾经终败给现在/ 2024年02月18日 17:33/ 0 赞/ 66 阅读

相关 Swagger注解

@API详细说明 ![这里写图片描述][70] @ApiImplicitParam ![这里写图片描述][70 1] [70]: /images/202205

傷城~/ 2022年05月22日 07:37/ 0 赞/ 320 阅读

相关 Swagger注解-@ResponseHeader

使用场景作为 @ApiResponse 的属性，作为返回数据的一部分，指定返回 header 信息概述作为返回数据的一部分提供返回数据的 header 信息

た入场券/ 2022年02月14日 06:17/ 0 赞/ 609 阅读

相关 Swagger注解-@ApiOperation

使用场景在 Rest 接口上使用概述描述针对特定路径的操作，通常是 HTTP 方法。具有等效路径的操作被分到单个分组中。HTTP 方法和路径的组合创建了一个

淩亂°似流年/ 2022年02月14日 06:17/ 0 赞/ 945 阅读

相关 Swagger注解-@ApiParam

使用场景在 Rest 接口上或 Rest 接口参数前边使用概述为 Rest 接口参数添加其它元数据(导入到 yapi 中不会被解析) 属性 <tab

骑猪看日落/ 2022年02月14日 06:17/ 0 赞/ 361 阅读

相关 Swagger注解-@SwaggerDefinition

使用场景定义 metadata level 时使用，在 Rest 接口或类上使用概述配置定义 metadata level的注解。仍然缺少 Security

秒速五厘米/ 2022年02月14日 06:15/ 0 赞/ 470 阅读

相关 Swagger注解-@ExternalDocs

使用场景使用外部文档说明的时候使用，参数，方法，属性上可使用概述定义外部文档说明属性 <table> <thead> <tr>

た入场券/ 2022年02月14日 06:13/ 0 赞/ 370 阅读

相关 Swagger注解-@Api

使用场景在 Rest 接口类上边使用。概述标记类为 Swagger 资源类，运行时有效。属性 <table> <thead> <tr>

绝地灬酷狼/ 2022年02月14日 06:13/ 0 赞/ 378 阅读

相关 Swagger注解

swagger通过注解表明该接口会生成文档，包括接口名、请求方法、参数、返回信息的等等。 @Api：修饰整个类，描述Controller的作用

短命女/ 2021年10月18日 22:46/ 0 赞/ 532 阅读