.NETCoreWebAPI如何集成Swagger做接口管理-創(chuàng)新互聯(lián)

本篇文章為大家展示了.NET Core WebAPI如何集成Swagger做接口管理，內(nèi)容簡(jiǎn)明扼要并且容易理解，絕對(duì)能使你眼前一亮，通過這篇文章的詳細(xì)介紹希望你能有所收獲。

專注于為中小企業(yè)提供成都網(wǎng)站設(shè)計(jì)、做網(wǎng)站服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)新絳免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都，凝聚了一批互聯(lián)網(wǎng)行業(yè)人才，有力地推動(dòng)了近千家企業(yè)的穩(wěn)健成長(zhǎng)，幫助中小企業(yè)通過網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。

什么是Swagger？
Swagger 是一個(gè)規(guī)范且完整的框架，用于生成、描述、調(diào)用和可視化 RESTful 風(fēng)格的 Web 服務(wù)。
Swagger 的目標(biāo)是對(duì) REST API 定義一個(gè)標(biāo)準(zhǔn)且和語(yǔ)言無(wú)關(guān)的接口，可以讓人和計(jì)算機(jī)擁有無(wú)須訪問源碼、文檔或網(wǎng)絡(luò)流量監(jiān)測(cè)就可以發(fā)現(xiàn)和理解服務(wù)的能力。當(dāng)通過 Swagger 進(jìn)行正確定義，用戶可以理解遠(yuǎn)程服務(wù)并使用最少實(shí)現(xiàn)邏輯與遠(yuǎn)程服務(wù)進(jìn)行交互。與為底層編程所實(shí)現(xiàn)的接口類似，Swagger 消除了調(diào)用服務(wù)時(shí)可能會(huì)有的猜測(cè)。

Swagger 有什么優(yōu)勢(shì)？
支持 API 自動(dòng)生成同步的在線文檔：使用 Swagger 后可以直接通過代碼生成文檔，不再需要自己手動(dòng)編寫接口文檔了，對(duì)程序員來(lái)說非常方便，可以節(jié)約寫文檔的時(shí)間去學(xué)習(xí)新技術(shù)。
提供 Web 頁(yè)面在線測(cè)試 API：光有文檔還不夠，Swagger 生成的文檔還支持在線測(cè)試。參數(shù)和格式都定好了，直接在界面上輸入?yún)?shù)對(duì)應(yīng)的值即可在線測(cè)試接口。

在.NET Core中如何使用Swagger？
（1）準(zhǔn)備工作
創(chuàng)建一個(gè).NET Core WebApi 項(xiàng)目
創(chuàng)建一個(gè)Model類庫(kù)

（2）在項(xiàng)目中引入Swagger
在WebApi項(xiàng)目中執(zhí)行命令：Install-package Swashbuckle.AspNetCore

（3）在StarUp.cs的ConfigureServices中添加代碼

#region Swagger
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new Info
                {
                    Version = "v1.1.0",
                    Title = "Swagger WebAPI",
                    Description = "XXX項(xiàng)目API文檔",
                    TermsOfService = "None",
                    Contact = new Swashbuckle.AspNetCore.Swagger.Contact { Name = "XXX項(xiàng)目", Email = "[email protected]"
                    , Url = "https://www.cnblogs.com/NBIDataVis/" }
                });
                var basePath = Path.GetDirectoryName(typeof(Program).Assembly.Location);
                //添加接口XML的路徑
                var xmlPath = Path.Combine(basePath, "TrySwaggerCore.xml");
                //如果需要顯示控制器注釋只需將第二個(gè)參數(shù)設(shè)置為true
                c.IncludeXmlComments(xmlPath, true);
            });
 #endregion

（4）在StarUp.cs的Configure中添加代碼

#region Swagger
app.UseSwagger();
app.UseSwaggerUI(c =>
{
  c.SwaggerEndpoint("/swagger/v1/swagger.json", "ApiDocument V1");
});
#endregion

（5）運(yùn)行后進(jìn)入/swagger目錄 即可查看Swagger已經(jīng)啟用

問題匯總：
（1）如果需要將WebApi的默認(rèn)啟動(dòng)頁(yè)設(shè)為Swagger則在Properties中

（2）在這里大家會(huì)發(fā)現(xiàn)運(yùn)行后接口的注釋并沒有顯示，我們需要配置注釋XML文件
在WebAPI項(xiàng)目上點(diǎn)擊右鍵-》屬性-》生成-》XML文檔文件

另外切記此處代碼第二個(gè)參數(shù)需要設(shè)置為True，否則將不顯示控制器級(jí)別的注釋，只顯示接口注釋

（3）如果大家會(huì)發(fā)現(xiàn)有了許多警告，強(qiáng)迫癥患者看這里，我們只需要在生成中強(qiáng)制過濾1591的警告即可

上述內(nèi)容就是.NET Core WebAPI如何集成Swagger做接口管理，你們學(xué)到知識(shí)或技能了嗎？如果還想學(xué)到更多技能或者豐富自己的知識(shí)儲(chǔ)備，歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。

另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)cdcxhl.cn，海內(nèi)外云服務(wù)器15元起步，三天無(wú)理由+7*72小時(shí)售后在線，公司持有idc許可證，提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國(guó)服務(wù)器、虛擬主機(jī)、免備案服務(wù)器”等云主機(jī)租用服務(wù)以及企業(yè)上云的綜合解決方案，具有“安全穩(wěn)定、簡(jiǎn)單易用、服務(wù)可用性高、性價(jià)比高”等特點(diǎn)與優(yōu)勢(shì)，專為企業(yè)上云打造定制，能夠滿足用戶豐富、多元化的應(yīng)用場(chǎng)景需求。

網(wǎng)站欄目：.NETCoreWebAPI如何集成Swagger做接口管理-創(chuàng)新互聯(lián)
網(wǎng)站鏈接：http://www.jbt999.com/article42/shhec.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供關(guān)鍵詞優(yōu)化、網(wǎng)站策劃、自適應(yīng)網(wǎng)站、域名注冊(cè)、網(wǎng)站改版、響應(yīng)式網(wǎng)站

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：[email protected]。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來(lái)源： 創(chuàng)新互聯(lián)