Swagger注解-@SwaggerDefinition

秒速五厘米 2022-02-14 06:15 482阅读 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 条评论，482人围观）

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

相关阅读

相关 Swagger注解

Swagger是一个开源的API文档工具，可以自动生成API文档，方便开发人员查看和调用API接口。在Java开发中，我们可以使用Swagger注解来描述API接口和参数，从而

短命女/ 2024年03月16日 18:34/ 0 赞/ 80 阅读

相关 swagger注解。

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

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

相关 Swagger——介绍、使用Swagger注解

目录 Swagger 1、什么是Swagger 2、官方提供的工具 3、构建Swagger与SpringBoot

Love The Way You Lie/ 2023年02月27日 08:27/ 0 赞/ 18 阅读

相关 Swagger注解

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

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

相关 Swagger注解-@ResponseHeader

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

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

相关 Swagger注解-@ApiParam

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

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

相关 Swagger注解-@SwaggerDefinition

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

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

相关 Swagger注解-@ExternalDocs

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

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

相关 Swagger注解-@Api

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

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

相关 Swagger注解

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

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