[[273129]]

【51CTO.com快譯】ASP.Net Core是微軟的一種開源跨平臺框架，具有可擴展、精簡化和模塊化的優點，可用于構建高性能Web應用程序。中間件組件可以用在ASP.Net Core請求管道中，定制處理請求和響應的方式。

ASP.Net Core中間件組件還可用于檢查、路由或修改流經管道的請求和響應消息。本文討論了如何用ASP.Net Core中的中間件執行一些高級操作。

創建ASP.Net Core MVC項目

首先，不妨在Visual Studio中創建一個ASP.Net Core項目。假設你的系統中已安裝Visual Studio 2017或Visual Studio 2019，按照下列步驟，在Visual Studio中創建一個新的ASP.Net Core項目。

1. 啟動Visual Studio IDE。
2. 點擊“創建新項目”。
3. 在“創建新項目”窗口中，從顯示的模板列表中選擇“ASP.Net Core Web應用程序”。
4. 點擊“下一步”。
5. 在“配置新項目”窗口中，指定新項目的名稱和位置。
6. 點擊“創建”。
7. 在接下來顯示的“創建新的ASP.Net Core Web應用程序”中，從頂部的下拉列表中選擇.Net Core作為運行時環境和ASP.Net Core 2.2(或更高版本)。
8. 選擇“Web應用程序(模型-視圖-控制器)”作為項目模板，創建一個新的ASP.Net Core應用程序。
9. 確保“啟用Docker支持”和“針對HTTPS的配置”復選框未勾選，因為我們在此處不會使用那些功能。
10. 確保身份驗證設置為“無身份驗證”，因為我們也不會使用身份驗證。
11. 點擊“創建”。

遵循這些步驟應該可以在Visual Studio中創建一個新的ASP.Net Core項目。我們將在本文的后續部分中使用該項目。

ASP.Net Core中的Use、Run和Map等方法

Use、Map和Run等方法用于在ASP.Net Core中配置HTTP管道。下面簡要介紹這每個方法及用途。

• Use——該方法將執行委托(delegate)，然后進入到管道中的下一步。Use方法還可用于使管道短路。
• Run——該方法將執行委托并返回結果。
• Map——該方法將有條件地執行委托并返回結果。

ASP.Net Core中注冊中間件

ASP.Net Core中的中間件組件在Startup類的Configure方法中注冊。Use *擴展方法用于注冊中間件。下面是注冊中間件組件的語法。 

public void Configure(IApplicationBuilder app, IHostingEnvironment env)  
{  
app.UseMyCustomMiddleware();  
} 

值得一提的是，中間件組件按它們注冊的順序來加以執行。

ASP.Net Core中的Invoke方法

每個中間件組件都包含一個Invoke方法。該方法接受對HttpContext實例的引用作為實參。中間件組件可以在調用下一個中間件組件前后執行操作。下面是典型的Invoke方法的示例： 

public async Task Invoke(HttpContext context)  
{  
// Write code here that will be executed before the  
// next middleware is called  
await _next.Invoke(context); // call next middleware  
// Write code here that will be executed after the  
//next middleware is called  
} 

ASP.Net Core中使HTTP管道分支

Map擴展方法(即Map和MapWhen)用于使管道分支。Map用于基于特定的請求路徑來分支，而MapWhen用于基于特定斷言的結果來分支。

下列代碼片段表明了Map方法如何用于使請求管道分支。 

public class Startup  
{  
private static void MapRequestA(IApplicationBuilder app)  
{  
app.Run(async context =>  
{  
await context.Response.WriteAsync("This is MapRequestA");  
});  
}  
private static void MapRequestB(IApplicationBuilder app)  
{  
app.Run(async context =>  
{  
await context.Response.WriteAsync("This is MapRequestB");  
});  
}  
private static void MapRequestC(IApplicationBuilder app)  
{  
app.Run(async context =>  
{  
await context.Response.WriteAsync("This is MapRequestC");  
});  
}  
public void Configure(IApplicationBuilder app)  
{  
app.Map("/mapRequestPathA", MapRequestA);  
app.Map("/mapRequestPathB", MapRequestB);  
app.Map("/mapRequestPathB", MapRequestC);  
app.Run(async context =>  
{  
await context.Response.WriteAsync("Hello World!");  
});  
}  
//Other methods  
} 

MapWhen方法接受兩個參數：

• Func
• 委托操作

你可以在Startup類的Configure方法中使用下列代碼片段，不允許內容類型“text/html”。 

public void Configure(IApplicationBuilder app, IHostingEnvironment env)  
{  
if (env.IsDevelopment())  
{  
app.UseDeveloperExceptionPage();  
}  
app.MapWhen(context => context.Request.ContentType.Equals  
("text/xml", StringComparison.InvariantCultureIgnoreCase),  
(IApplicationBuilder applicationBuilder) =>  
{  
applicationBuilder.Run(async context =>  
{  
await Task.FromResult(context.Response.StatusCode = StatusCodes.Status406NotAcceptable);  
});  
});  
app.UseMvc();  
} 

ASP.Net Core中的UseWhen方法

UseWhen方法可用于有條件地執行中間件。下列代碼片段表明了如果請求路徑以“/api”開頭，UseWhen方法如何用于執行中間件組件。 

app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), applicationBuilder =>  
{  
applicationBuilder.UseCustomMiddleware();  
}); 

請注意：與MapWhen不同，UseWhen方法繼續執行后一個中間件，不管UseWhen斷言是真還是假。不妨通過示例了解這一點?？紤]下面這部分代碼： 

app.UseMiddlewareA(); 
app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), applicationBuilder =>  
{  
applicationBuilder.UseMiddlewareB();  
});  
app.UseMiddlewareC(); 

如果中間件沒有短路，中間件A和C將始終執行。只有請求路徑以“/api”開關，中間件B才會執行。

在ASP.Net Core中，請求處理管道中有一連串中間件組件。所有請求和響應都流經該管道。新請求進入后，這些中間件組件或處理請求，或將請求傳遞到管道中的下一個組件。想完成更復雜的請求處理，我們可以使用Map和MapWhen方法使管道分支，使用UseWhen有條件地執行中間件。

【51CTO譯稿，合作站點轉載請注明原文譯者和出處為51CTO.com】