swagger常用注解
来源:互联网 发布:c语言for循环打印图形 编辑:程序博客网 时间:2024/05/22 12:38
一、swagger常用注解
1、与模型相关的注解
两个注解:
- @ApiModel:用在模型类上,对模型类做注释;
- @ApiModelProperty:用在属性上,对属性做注释
2、与接口相关的注解
六个注解:
- @Api:用在controller上,对controller进行注释;
- @ApiOperation:用在API方法上,对该API做注释,说明API的作用;
- @ApiImplicitParams:用来包含API的一组参数注解,可以简单的理解为参数注解的集合声明;
- @ApiImplicitParam:用在@ApiImplicitParams注解中,也可以单独使用,说明一个请求参数的各个方面,该注解包含的常用选项有:
- paramType:参数所放置的地方,包含query、header、path、body以及form,最常用的是前四个。
- name:参数名;
- dataType:参数类型,可以是基础数据类型,也可以是一个class;
- required:参数是否必须传;
- value:参数的注释,说明参数的意义;
- defaultValue:参数的默认值;
- @ApiResponses:通常用来包含接口的一组响应注解,可以简单的理解为响应注解的集合声明;
- @ApiResponse:用在@ApiResponses中,一般用于表达一个错误的响应信息
- code:即httpCode,例如400
- message:信息,例如"请求参数没填好"
二、几个注意点:
- 为了在swagger-ui上看到输出,至少需要两个注解:@Api和@ApiOperation
- 即使只有一个@ApiResponse,也需要使用@ApiResponses包住
- 对于@ApiImplicitParam的paramType:query、form域中的值需要使用@RequestParam获取, header域中的值需要使用@RequestHeader来获取,path域中的值需要使用@PathVariable来获取,body域中的值使用@RequestBody来获取,否则可能出错;而且如果paramType是body,name就不能是body,否则有问题,与官方文档中的“If paramType is "body", the name should be "body"不符。
阅读全文
1 0
- swagger常用注解
- swagger常用注解说明
- swagger 常用注解
- swagger常用注解
- swagger常用注解
- swagger常用注解说明
- swagger常用注解说明
- Swagger的三个常用注解
- Swagger常用注解API介绍
- swagger注解
- swagger注解
- Swagger注解
- swagger注解说明
- springboot + swagger 注解
- springboot + swagger注解
- swagger注解 详细说明
- swagger注解说明
- swagger注解的使用
- 数据结构---后序遍历
- NSOJ 我排第几个
- HD6015 Skip the Class
- Spark 简易入门教程(Java的微型Web框架)
- Java基础知识2
- swagger常用注解
- 阿里MNS服务:代码显示成功并可以得到消息id及其md5,手机却收不到短信
- Java内部类知识
- P1914 小书童——密码
- 关于linux(ubuntu)中直接右键复制粘贴与cp命令的区别
- [学习笔记]UE4--多线程的实现方式
- 1809: 不容易系列之一
- libevent源码分析(5)--2.1.8--libevent配置信息对象struct event_config的申请和释放函数分析
- 用cat命令向文件末尾追加