ASP.NET Core 運行原理剖析2:Startup 和 Middleware(中間件)

Startup Class

Startup Class中含有兩個重要方法：Configure方法用於每次http請求的處理，好比後面要講的中間件(Middleware)，就是在configure方法中配置。而ConfigureServices方法在Configure方法前調用，它是一個可選的方法，可在configureServices依賴注入接口或一些全局的框架，好比EntityFramework、MVC等。Startup 類的 執行順序：構造 -> configureServices->configure。

一、Startup Constructor（構造函數）

主要實現一些配置的工做，方法參數以下：

• IHostingEnvironment: 用於訪問應用程序的特殊屬性，好比applicationName,applicationVersion。經過IHostingEnvironment對象下的屬性能夠在構造中實現配置工做。好比獲取當前根路徑找到配置json文件地址，而後ConfigurationBuilder初始化配置文件，最後能夠經過GetSection()方法獲取配置文件。代碼清單以下：

var builder = new ConfigurationBuilder()                            .SetBasePath(env.ContentRootPath)                             .AddJsonFile("appsettings.json");                     var configuration = builder.Build();                     var connStr = configuration.GetSection("Data:DefaultConnection:ConnectionString").Value;

根目錄下的配置文件以下：

{    "Data": {        "DefaultConnection": {            "ConnectionString": "Server=(localdb)\\MSSQLLocalDB;Database=_CHANGE_ME;Trusted_Connection=True;"        }    }}

• ILoggerFactory: 提供建立日誌的接口，能夠選用已經實現接口的類或自行實現此接口,下面代碼使用最簡單的控制檯做爲日誌輸出。

public Startup(IHostingEnvironment env, ILoggerFactory logger) {         var log = logger.CreateLogger("default");         logger.AddConsole();         log.LogInformation("start configure"); }

二、ConfigureServices

主要實現了依賴注入(DI)的配置，方法參數以下：

• IServiceCollection：整個ASP.NET Core 默認帶有依賴注入(DI)，IServiceCollection是依賴注入的容器，首先建立一個類(Foo)和接口(IFoo),代碼清單以下：

using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;namespace WebApplication1{   public interface IFoo    {        string GetFoo();    } }

using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;namespace WebApplication1{    public class Foo : IFoo    {        public string GetFoo()        {            return "foo";        }    } }

在ConfigureServices 中將接口和實現注入至容器

public void ConfigureServices(IServiceCollection services)       {           services.AddTransient<ifoo, foo="">();       }

若是想在每次Http請求後都使用IFoo的GetFoo()方法來處理，上面講到能夠在Configure方法中註冊函數，在註冊過程當中因爲使用了依賴注入(DI)，所以能夠直接經過RequestServices.GetRequiredService()泛型方法將IFoo對象在容器中取出。

app.Run((context) =>           {               var str = context.RequestServices.GetRequiredService().GetFoo();               return context.Response.WriteAsync(str);           });

除了本身的接口外,還支持經過擴展方法添加更多的注入方法，好比EntityFramework、mvc框架都實現本身的添加方法。

public void ConfigureServices(IServiceCollection services){    // Add framework services.    services.AddDbContext(options =>        options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));    services.AddIdentity<applicationuser, identityrole="">()        .AddEntityFrameworkStores()        .AddDefaultTokenProviders();    services.AddMvc();    // Add application services.     services.AddTransient<ifoo, foo="">(); }

三、Configure方法

主要是http處理管道配置和一些系統配置，參數以下：

• IApplicationBuilder: 用於構建應用請求管道。經過IApplicationBuilder下的run方法傳入管道處理方法。這是最經常使用方法，對於一個真實環境的應用基本上都須要好比權限驗證、跨域、異常處理等。下面代碼調用IApplicationBuilder.Run方法註冊處理函數。攔截每一個http請求，輸出Hello World。

public void Configure(IApplicationBuilder app){    app.Run((context) => context.Response.WriteAsync("Hello World!")); }

• IHostingEnvironment: 同構造參數

• ILoggerFactory: 同構造參數

Middleware

中間件是一個處理http請求和響應的組件，多箇中間件構成了處理管道(Handler pipeline)，每一箇中間件能夠決定是否傳遞至管道中的下一中間件。一旦註冊中間件後，每次請求和響應均會被調用。

一、中間件註冊

中間件的註冊在startup中的Configure方法完成，在configure方法中使用IApplicationBuilder對象的Run、Map、Use方法傳入匿名委託(delegate)。上文示例註冊IFoo.GetFoo()方法就是一個典型的中間件。

• Run & Use: 添加一箇中間件至請求管道。它們在功能很相似可是也存在一些區別，先來看下兩個方法的定義。

public static IApplicationBuilder Use(this IApplicationBuilder app, Func<httpcontext, func<task="">, Task> middleware); public static void Run(this IApplicationBuilder app, RequestDelegate handler);

Run是經過擴展方法語法來定義，傳入入參是RequestDelegate的委託,執行完一個第一個run後是不會激活管道中的第二個run方法，這樣代碼執行結果只會輸出一個「hello world!」

app.Run((context) => context.Response.WriteAsync("Hello World!")); app.Run((context) => context.Response.WriteAsync("Hello World 1!"));

而use方法的入參則是Func<>的委託包含兩個入參和一個返回值,這樣在第一個函數執行完成後能夠選擇是否繼續執行後續管道中的中間件仍是中斷。

app.Use((context, next) =>                     {                             context.Response.WriteAsync("ok");                             return next();                     }); app.Use((context, next) =>                     {                             return context.Response.WriteAsync("ok");                     });

• Map: 含有兩個參數pathMatche和configuration，經過請求的url地址匹配相應的configuration。例如能夠將url路徑是/admin的處理函數指定爲以下代碼：

app.Map("/admin", builder =>                    {                            builder.Use((context, next) => context.Response.WriteAsync("admin"));                    });

二、經常使用中間件

Middleware	功能描述
Authentication	提供權限支持
CORS	跨域的配置
Routing	配置http請求路由
Session	管理用戶會話
Static Files	提供對靜態文件的瀏覽

這裏有一些官方的示例,連接

---

以上內容有任何錯誤或不許確的地方請你們指正，不喜勿噴！

做者：帥蟲哥 出處： http://www.cnblogs.com/vipyoumay/p/5640645.html

本文版權歸做者和博客園共有，歡迎轉載，但未經做者贊成必須保留此段聲明，且在文章頁面明顯位置給出原文鏈接，不然保留追究法律責任的權利。若是以爲還有幫助的話，能夠點一下右下角的【推薦】，但願可以持續的爲你們帶來好的技術文章！想跟我一塊兒進步麼？那就【關注】我吧。

參考連接

[1] https://docs.asp.net/en/latest/fundamentals/middleware.html

[2] http://www.talkingdotnet.com/app-use-vs-app-run-asp-net-core-middleware/

相關文章：

• ASP.NET Core 1.0 入門——瞭解一個空項目

• ASP.NET Core 1.0 部署 HTTPS （.NET Framework 4.5.1）

• .NET Core 1.0、ASP.NET Core 1.0和EF Core 1.0簡介

• 雲服務器下ASP.NET Core 1.0環境搭建（包含mono與coreclr）

• 使用VS Code開發ASP.NET Core 應用程序

• dotnet run是如何啓動asp.net core站點的

• ASP.NET Core提供模塊化Middleware組件

• 「dotnet restore"和"dotnet run"都作了些什麼？

• 探祕 dotnet run 如何運行 .NET Core 應用程序

• .NET Portability Analyzer 已開源

• ASP.NET Core的配置（1）：讀取配置信息

• ASP.NET Core的配置（2）：配置模型詳解

• .NET Core 1.0 RC2 歷險之旅

• 使用VS Code開發 調試.NET Core 應用程序

• 讓咱們Core在一塊兒：ASP.NET Core & .NET Core

• .NET Core VS Code 環境配置

• 官方博客明確了 .NET Core RC2/RTM 時間表

• .NET Core全新的配置管理[共9篇]

• 利用記事本建立一個ASP.NET Core RC2 MVC應用

• 微軟.NET 正式劈腿成功，橫跨全部平臺

• .NET Core 1.0 CentOS7 嘗試

• 解讀發佈：.NET Core RC2 and .NET Core SDK Preview 1

• [.NET Core].NET Core R2安裝及示例教程

• ASP.NET Core 開發-中間件(Middleware)

• 結合Jexus + Kestrel 部署 asp.net core 生產環境

• 經過Jexus 部署 dotnetcore版本MusicStore 示例程序

• ASP.NET Core 中文文檔 第一章 入門

• 用 Visual Studio Code 在 macOS 上建立首個 ASP.NET Core 應用程序

• 用 Visual Studio 和 ASP.NET Core MVC 建立首個 Web API

• 用 Visual Studio 發佈一個 Azure 雲 Web 應用程序

• ASP.NET Core MVC 與 Visual Studio 入門

• 第二章指南（4.2）添加 Controller

• DotNet Core 介紹

• asp.net core 中間件詳解及項目實戰

• 教你實踐ASP.NET Core Authorization（免看文檔教程）

• asp.net core 使用 Redis 和 Protobuf 進行 Session 緩存

• asp.net core 中間件詳解及項目實戰

• 第二章 指南（4.3）添加 View

• dotnet core開發體驗之開始MVC

• dotnet core 開發體驗之Routing

• 聊聊ASP.NET Core默認提供的這個跨平臺的服務器——KestrelServer

• 簡析.NET Core 以及與 .NET Framework的關係

• .NET Core 使用Dapper 操做MySQL

• 使用 CommandLineApplication 類建立專業的控制檯程序

• 簡析 .NET Core 構成體系

• .NET Core也可使用MongoDB了

• .NET Core & ASP.NET Core 1.0在Redhat峯會上正式發佈

• .NET Core：面向將來的開源跨平臺開發技術

• 微軟說它深愛着Linux，如今它用行動證實了

• 移植.NET Core計劃，整合各平臺變得更簡單了！

• ASP.NET Core 介紹

• 經過幾個Hello World感覺.NET Core全新的開發體驗

• ASP.NET Core 運行原理剖析1:初始化WebApp模版並運行

• .NET Core系列 ： 一、.NET Core 環境搭建和命令行CLI入門

• Asp.Net Core 發佈和部署（ MacOS + Linux + Nginx ）

• Asp.Net Core 發佈和部署（Linux + Jexus ）

• 學習ASP.NET Core，你必須瞭解無處不在的「依賴注入」

• .NET Core應用類型（Portable apps & Self-contained apps）