@Api:用在请求的类上,表示对类的说明
tags="说明该类的作用,可以在UI界面上看到的注解"
value="该参数没什么意义,在UI界面上也看到,所以不需要配置"

@ApiOperation:用在请求的方法上,说明方法的用途、作用
value="说明方法的用途、作用"
notes="方法的备注说明"

@ApiImplicitParams:用在请求的方法上,表示一组参数说明
@ApiImplicitParam:用在@ApiImplicitParams注解中,指定一个请求参数的各个方面
name:参数名
value:参数的汉字说明、解释
required:参数是否必须传
paramType:参数放在哪个地方
· header --> 请求参数的获取:@RequestHeader
· query --> 请求参数的获取:@RequestParam
· path(用于restful接口)--> 请求参数的获取:@PathVariable
· body(不常用)
· form(不常用)
dataType:参数类型,默认String,其它值dataType="Integer"
defaultValue:参数的默认值

@ApiResponses:用在请求的方法上,表示一组响应
@ApiResponse:用在@ApiResponses中,一般用于表达一个错误的响应信息
code:数字,例如400
message:信息,例如"请求参数没填好"
response:抛出异常的类

@ApiModel:用于响应类上,表示一个返回响应数据的信息
(这种一般用在post创建的时候,使用@RequestBody这样的场景,
请求参数无法使用@ApiImplicitParam注解进行描述的时候)
@ApiModelProperty:用在属性上,描述响应类的属性

最新文章

  1. Mac OS X 懒人版安装教程(之前的图全部挂了,所以重发了)
  2. Html5的DeviceOrientation特性
  3. hiho_1048_状态压缩2
  4. Nginx+Keepalived主备负载均衡
  5. Python Tutorial 学习(六)--Modules
  6. Vim及VimScript资料总结《转载》
  7. Map.EntrySet的使用方法
  8. AspNetCore.Hosting
  9. zookeeper+dubbo简单使用
  10. 《AutoCAD Civil 3D .NET二次开发》勘误2
  11. 初识GetMapping(""),使用方法
  12. css- @media @font-face 的理解
  13. Alpha冲刺 - (4/10)
  14. 整合多个网络的拓扑结构并降维(Mashup)
  15. Oracle常用表和常见操作命令
  16. python2.7 调用 .net的webservice asmx
  17. OpenCV中GPU函数
  18. python基础知识-11-函数装饰器
  19. python学习笔记——进程间通信方式对比
  20. [Bootstrap 源码解析]——bootstrap源码之初始化

热门文章

  1. 关于Qrc文件的用法
  2. Laravel 5.3 单用户登录的简单实现
  3. Unable to connect to MKS;Too many scoket connect attempts;giving up
  4. MySQL 8.0 中统计信息直方图的尝试
  5. UE4 C++ 笔记
  6. spring boot 2 统一异常处理
  7. neo4j性能调优(转)
  8. linux bash shell:最方便的字符串大小写转换(lowercase/uppercase conversion) (转)
  9. 面向对象的 __slots__
  10. tiny4412 --Uboot移植(5) DDR3内存