欧美一级特黄大片做受成人-亚洲成人一区二区电影-激情熟女一区二区三区-日韩专区欧美专区国产专区

如何進行swaggerui快速入門

這篇文章給大家介紹如何進行swagger ui快速入門,內(nèi)容非常詳細(xì),感興趣的小伙伴們可以參考借鑒,希望對大家能有所幫助。

創(chuàng)新互聯(lián)公司2013年成立,先為資中等服務(wù)建站,資中等地企業(yè),進行企業(yè)商務(wù)咨詢服務(wù)。為資中企業(yè)網(wǎng)站制作PC+手機+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問題。

快速啟動

1 引入相關(guān)依賴

<dependency>
    <groupId>com.yishuifengxiao.common</groupId>
    <artifactId>common-spring-boot-starter</artifactId>
    <version>4.1.2</version>
</dependency>

2 開啟配置

在配置文件中加入以下配置即可快速開啟 swagger-ui 功能。

yishuifengxiao.swagger.base-package= 需要掃描的控制器代碼的路徑

加入上述配置后即可通過 http://ip:port/doc.html 查看 swagger-ui 增強文檔。

如何進行swagger ui快速入門

如何進行swagger ui快速入門

也可以通過 http://ip:port/swagger-ui.html 查看 swagger-ui 原生文檔。

此外,也可以通過http://ip:port/v2/api-docs查看元數(shù)據(jù)

這里只是簡化了 swagger-ui 的掃描注解,對于軟件開發(fā)過程中必須 swagger-ui 其他 API 注解仍然不可省略。

下面是一個簡單的 swagger-ui 配置文檔示例

@Api(value = "【測試接口】測試接口", tags = {"測試接口"})
@Valid
@Controller
@RequestMapping
@Slf4j
public class WebConftroller  {

    @ApiImplicitParams({
            @ApiImplicitParam(name = "username", value = "登錄的用戶名"),
            @ApiImplicitParam(name = "loginIp", value = "登錄ip"),
            @ApiImplicitParam(name = "pass", value = "登錄結(jié)果,true表示成功,false失敗"),
            @ApiImplicitParam(name = "pageSize", value = "分頁大小,分頁的大小不能小于1,默認(rèn)值為20"),
            @ApiImplicitParam(name = "pageNum", value = "當(dāng)前頁的頁碼,頁碼的大小不能小于1,默認(rèn)值為1")})
    @ApiOperation(value = "分頁查詢登錄記錄", notes = "分頁查詢登錄記錄")
    @GetMapping("/demo")
    @ResponseBody
    public Response<String> findPage(
        HttpServletRequest request, HttpServletResponse response,
        @RequestParam(value = "username", required = false) String username,
        @RequestParam(value = "loginIp", required = false) String loginIp,
        @RequestParam(value = "pass", required = false) Boolean pass,
        @RequestParam(name = "pageSize", defaultValue = "20", required = false) Integer pageSize,
        @RequestParam(name = "pageNum", defaultValue = "1", required = false) Integer pageNum) {

        return Response.suc();

    }

}

<br/>

特別鳴謝

此項功能中的 doc.html 界面中功能使用到了刀哥的 swagger-bootstrap-ui 中的功能 ,在此特別感謝 刀哥 的大力支持,關(guān)于 swagger-bootstrap-ui 的詳細(xì)說明請參見刀哥的 swagger-bootstrap-ui 文檔

配置參數(shù)

# swagger-ui文檔的標(biāo)題
yishuifengxiao.swagger.title=API接口文檔
# swagger-ui文檔描述
yishuifengxiao.swagger.description=易水風(fēng)蕭 接口說明文檔
#swagger-ui 項目服務(wù)的url
yishuifengxiao.swagger.terms-of-service-url=http://www.yishuifengxiao.com/
# swagger-ui 文檔分組的名字
yishuifengxiao.swagger.group-name=default
# swagger-ui 文檔版本
yishuifengxiao.swagger.version=1.0.0
# 項目聯(lián)系人名字
yishuifengxiao.swagger.contact-user=yishuifengxiao
# 項目聯(lián)系的url
yishuifengxiao.swagger.contact-url=http://www.yishuifengxiao.com/
# 項目聯(lián)系郵箱
yishuifengxiao.swagger.contact-email=zhiyubujian@163.com

以上常規(guī)配置都有缺省默認(rèn)值,用戶在使用 易水風(fēng)蕭通用組件 時,如果沒有特別需要,使用默認(rèn)配置即可。

進階配置

一般情況下,使用 swagger-ui 的常規(guī)配置即可滿足日常開發(fā)需要,但是在某些情況下,可能需要一些高級配置。如,需要通過在所有的 API 接口上批量加上一個默認(rèn)參數(shù),此時即可用通用組件的高級配置功能了。

yishuifengxiao.swagger.contact.auths[0].name=Authorization
yishuifengxiao.swagger.contact.auths[0].description=自定義必填請求頭
yishuifengxiao.swagger.contact.auths[0].modelRef=string
yishuifengxiao.swagger.contact.auths[0].parameterType=header
yishuifengxiao.swagger.contact.auths[0].required=false

上述示例配置在 API 文檔中的所有請求中批量添加了一個參數(shù)名為 Authorization 的請求頭參數(shù)。yishuifengxiao.swagger.contact.auths 是一個數(shù)組,可以添加多個配置。

關(guān)于如何進行swagger ui快速入門就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,可以學(xué)到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。

網(wǎng)頁名稱:如何進行swaggerui快速入門
文章分享:http://aaarwkj.com/article8/ggpcip.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供網(wǎng)站設(shè)計響應(yīng)式網(wǎng)站、品牌網(wǎng)站設(shè)計、標(biāo)簽優(yōu)化、網(wǎng)站改版自適應(yīng)網(wǎng)站

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)

微信小程序開發(fā)
岛国毛片在线免费播放| 欧美一区二区三区人妻激情| 日本免费一区二区三个| 日韩av毛片在线观看| 999热这里只有精品视频| 蜜桃福利视频一区二区| 97免费公开在线观看| 成人黄色18免费网站| 国产成人av综合久久视色| 亚洲av综合色区一区| 国产精品久久久久大屁股精品性色 | 欧美女人又粗又长亚洲| 日韩三级精品一区二区| 久久国产亚洲精品赲碰热| 日韩精品一区免费电影| 午夜91激情福利视频| 在线欧美亚洲观看天堂| 韩国理伦三级做爰观看| 国产传媒在线视频观看| 中文字幕亚洲欧美日韩高清| 中文字幕国产精品91| 日本在线一区二区不卡视频| 日韩av在线国产观看| 亚洲成人日韩成人av| 福利午夜福利在线观看| 久久精品国产成人综合| 成人免费av在线网址| 国产又大又长又粗又硬又猛| 亚洲av成人三区国产精品| 欧美精品成人免费在线| 日本精品不卡一二三区| 人人妻夜夜天天俺去添噜| 未满十八禁止在线播放| 在线看黄色片播放器日韩| 精品国产一区二区三区精品日韩| 国产熟女乱免费一区二区| 亚洲av二区三区成人| 亚洲国产午夜福利在线69| 亚洲大片色一区在线观看| 中午字幕人妻少妇久久| 日本午夜一区二区在线观看|