中文字幕av专区_日韩电影在线播放_精品国产精品久久一区免费式_av在线免费观看网站

溫馨提示×

溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊×
其他方式登錄
點擊 登錄注冊 即表示同意《億速云用戶服務條款》

swagger 返回值描述

發布時間:2020-03-27 09:09:45 來源:網絡 閱讀:16645 作者:liuhanling 欄目:軟件技術

今天被前端訓了一頓,慌得一逼,說你們寫的接口,返回值寫的是什么東西,只有公共的三個字段......


我們的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 返回值描述

向AI問一下細節

免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。

AI

肇东市| 宣威市| 高雄县| 宁德市| 雷波县| 哈密市| 开远市| 剑阁县| 彭泽县| 黎平县| 嘉祥县| 方城县| 池州市| 汽车| 福海县| 富民县| 纳雍县| 夹江县| 长汀县| 依安县| 富宁县| 东台市| 元谋县| 怀宁县| 华宁县| 公安县| 麟游县| 山阴县| 井陉县| 磴口县| 石景山区| 巴彦淖尔市| 德令哈市| 台东县| 南郑县| 皋兰县| 将乐县| 肃南| 花垣县| 桂阳县| 广灵县|