這篇文章主要介紹了Asp.Net Core Swagger如何使用并帶域接口處理,具有一定借鑒價(jià)值,感興趣的朋友可以參考下,希望大家閱讀完這篇文章之后大有收獲,下面讓小編帶著大家一起了解一下。
成都創(chuàng)新互聯(lián)公司是一家專業(yè)提供趙縣企業(yè)網(wǎng)站建設(shè),專注與網(wǎng)站建設(shè)、做網(wǎng)站、H5頁面制作、小程序制作等業(yè)務(wù)。10年已為趙縣眾多企業(yè)、政府機(jī)構(gòu)等服務(wù)。創(chuàng)新互聯(lián)專業(yè)網(wǎng)站建設(shè)公司優(yōu)惠進(jìn)行中。Asp.Net的WebApi中使用Swagger作為說明和測試的頁面是非常不錯(cuò)的,比起WebApiTestClient來至少在界面上的很大的提升。但是使用Swagger時(shí)如果只是一般的控制器直接放到Controller下就可以了,而如果因不同的業(yè)務(wù)需求而需要分類或者有同名的類名時(shí)時(shí)則沒辦法很好的處理。
因?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;
}
}
}通過接口描述擴(kuò)展獲取區(qū)域及相關(guān)信息進(jìn)行改寫擴(kuò)展。
使用說明:
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í)等著你來學(xué)習(xí)!
網(wǎng)頁名稱:Asp.NetCoreSwagger如何使用并帶域接口處理-創(chuàng)新互聯(lián)
瀏覽地址:http://chinadenli.net/article10/ccgpgo.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供自適應(yīng)網(wǎng)站、服務(wù)器托管、網(wǎng)站導(dǎo)航、網(wǎng)站制作、全網(wǎng)營銷推廣、網(wǎng)站內(nèi)鏈
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請(qǐng)聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容