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

如何進行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人妻精品一区二| 中国的性生活黄片免费观看| 欧美日韩国产精品乱人伦| 18禁视频免费无遮挡| 国产成人av在线观看| 日韩欧美亚洲天堂视频| 亚洲国产精品激情在线| 人妻有码系列中文字幕专区| 中文字幕av免费专区| 欧美日韩亚洲中文二区| 91精品国产综合久蜜臂| 国产乡下三级_三级全黄| 日本黄色中文字幕网站| 三欲一区二区三区中文字幕| 国产精品免费看片网站| 婷婷国产成人久久精品激情| 亚洲天堂,男人的天堂| av天堂午夜在线观看| 亚洲国产日韩欧美在线播放| 久久精品国产亚洲av不丁香| 天天天干夜夜添狠操美女| 欧美亚洲av一区二区三区| 色哟哟在线观看国产精品| 人妻一区二区三区中文字幕| 亚洲国产日韩欧美综合久久| 欧美小黄片在线免费看| 国产产品在线免费看91| 国产精品伦一区二区三级| 麻豆国产av巨做国产剧情| 天天操天天干夜夜射| 在线日韩观看免费av| 国产精品久久久久精品爆| 日韩黄色一级片在线观看| 中文字幕精品高清中国| 日韩中文字幕在线二区| 水蜜桃成人在线视频免费观看| 亚洲成人日韩在线播放 | 精品欧美一区二区在线| 中文字幕日日夜夜av| 久久国产精品一区二区三区|