這篇文章主要介紹了Asp.Net Core Swagger如何使用并帶域接口處理,具有一定借鑒價(jià)值,感興趣的朋友可以參考下,希望大家閱讀完這篇文章之后大有收獲,下面讓小編帶著大家一起了解一下。
成都創(chuàng)新互聯(lián)公司是一家專業(yè)提供趙縣企業(yè)網(wǎng)站建設(shè),專注與網(wǎng)站建設(shè)、做網(wǎng)站、H5頁(yè)面制作、小程序制作等業(yè)務(wù)。10年已為趙縣眾多企業(yè)、政府機(jī)構(gòu)等服務(wù)。創(chuàng)新互聯(lián)專業(yè)網(wǎng)站建設(shè)公司優(yōu)惠進(jìn)行中。Asp.Net的WebApi中使用Swagger作為說(shuō)明和測(cè)試的頁(yè)面是非常不錯(cuò)的,比起WebApiTestClient來(lái)至少在界面上的很大的提升。但是使用Swagger時(shí)如果只是一般的控制器直接放到Controller下就可以了,而如果因不同的業(yè)務(wù)需求而需要分類或者有同名的類名時(shí)時(shí)則沒(méi)辦法很好的處理。
因?yàn)闃I(yè)務(wù)需求需要?jiǎng)?chuàng)建域,但是Swagger并未將域添加到接口。所以需要加上以下操作才行。
安裝Swagger方法:
為了大家多看微軟官方文檔、就直接引用Swagger安裝及使用方法。以下是微軟官方文檔。
https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-2.1&tabs=visual-studio
增加域接口顯示方法:
using Microsoft.AspNetCore.Mvc.ApiExplorer; using System.Collections.Generic; using System.Linq; using System.Text.RegularExpressions; namespace System.Web.Http.Description { /// <summary> /// API描述器擴(kuò)展 /// </summary> public static class ApiDescriptionExtension { /// <summary> /// 獲取區(qū)域名稱 /// </summary> /// <param name="description"></param> /// <returns></returns> public static List<string> GetAreaName(this ApiDescription description) { string areaName = description.ActionDescriptor.RouteValues["area"]; string controlName = description.ActionDescriptor.RouteValues["controller"]; List<string> areaList = new List<string>(); areaList.Add(controlName); if (!string.IsNullOrEmpty(areaName)) { description.RelativePath = $"{areaName}/{controlName}/{description.RelativePath}"; } return areaList; } } }
通過(guò)接口描述擴(kuò)展獲取區(qū)域及相關(guān)信息進(jìn)行改寫(xiě)擴(kuò)展。
使用說(shuō)明:
services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Swashbuckle.AspNetCore.Swagger.Info { Version = "v1.0.0", Title = " API", Description = description, TermsOfService = "你的公司", Contact = new Swashbuckle.AspNetCore.Swagger.Contact { Name = "Blog.Core", Email = "Blog.Core@xxx.com", Url = "https://www.jianshu.com/u/94102b59cc2a" } }); //使用域描述 c.TagActionsBy(apiDesc => apiDesc.GetAreaName()); var basePath = PlatformServices.Default.Application.ApplicationBasePath; var xmlPath = Path.Combine(basePath, xmlName);//這個(gè)就是剛剛配置的xml文件名 c.IncludeXmlComments(xmlPath, true);//默認(rèn)的第二個(gè)參數(shù)是false,這個(gè)是controller的注釋,記得修改 });
紅色部分加入代碼即可。
結(jié)果展示:
感謝你能夠認(rèn)真閱讀完這篇文章,希望小編分享的“Asp.Net Core Swagger如何使用并帶域接口處理”這篇文章對(duì)大家有幫助,同時(shí)也希望大家多多支持創(chuàng)新互聯(lián)網(wǎng)站建設(shè)公司,,關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道,更多相關(guān)知識(shí)等著你來(lái)學(xué)習(xí)!
網(wǎng)頁(yè)名稱:Asp.NetCoreSwagger如何使用并帶域接口處理-創(chuàng)新互聯(lián)
瀏覽地址:http://www.rwnh.cn/article10/ccgpgo.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供自適應(yīng)網(wǎng)站、服務(wù)器托管、網(wǎng)站導(dǎo)航、網(wǎng)站制作、全網(wǎng)營(yíng)銷推廣、網(wǎng)站內(nèi)鏈
聲明:本網(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;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來(lái)源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容
網(wǎng)頁(yè)設(shè)計(jì)公司知識(shí)