swagger返回值描述

今天被前端训了一顿,慌得一逼,说你们写的接口,返回值写的是什么东西,只有公共的三个字段......

创新互联公司专注于湘阴网站建设服务及定制,我们拥有丰富的企业做网站经验。 热诚为您提供湘阴营销型网站建设,湘阴网站制作、湘阴网页设计、湘阴网站官网定制、微信小程序开发服务,打造湘阴网络公司原创品牌,更为您提供湘阴网站排名全网营销落地服务。

我们的API文档是基于 swagger 组件写的.如是有了下面的东东

示例:

swagger 返回值描述

1.1.          返回字段

1.1.1. 返回字段(对象)

1.    将现有接口 @ApiOperation 注解,response字段去掉.

该字段作用:声明指定返回值对象

swagger 返回值描述

 

修改后:

swagger 返回值描述

 

2.    将返回对象进行泛型声明

声明后swagger(丝袜哥) 会反射生成对象字段描述

 swagger 返回值描述

3.    使用 @ApiModelPropety 注解写明字段含义

@ApiModelProperty("XXX")

 

示例:

 swagger 返回值描述

1.1.2. 返回字段(单字段)

对于单字段及5个字段以内,可以用此方式说明返回值

 

swagger 返回值描述

 

 

1.2.     请求字段

1.2.1. 请求字段(对象)

接口入参声明为对象接收

 swagger 返回值描述

对象字段用 @ApiParam 注解进行标注

 swagger 返回值描述

1.2.2. 请求字段(单字段或多字段)

单字段或多字段用 @ApiImplicitParams @ApiImplicitParam 进行标注

swagger 返回值描述


本文题目:swagger返回值描述
文章分享:http://myzitong.com/article/jshhsp.html