1. 程式人生 > >ASP.NET Core 中文文件 第三章 原理(1)應用程式啟動

ASP.NET Core 中文文件 第三章 原理(1)應用程式啟動

ASP.NET Core 為你的應用程式提供了處理每個請求的完整控制。Startup 類是應用程式的入口(entry point),這個類可以設定配置(configuration)並且將應用程式將要使用的服務連線起來。開發人員可以在 Startup 類中配置請求管道,該管道將用於處理應用程式的所有請求。

章節:

Startup 類

在 ASP.NET Core 中,Startup 類提供了應用程式的入口,而且在所有應用程式中都有 Startup 類。可能會存在特定環境的啟動類和方法(參見 Working with Multiple Environments),但無論如何, Startup 類都將被充當為應用程式的啟動點。ASP.NET 會在主程式集中搜索名為 Startup

 的類(在任何名稱空間下)。你可以指定一個其它程式集用於檢索,只需使用 Hosting:Application 配置鍵。ASP.NET 並不關心 Startup 類是不是定義為 public,如果它符合命名規範,ASP.NET 將繼續載入它。如果有多個 Startup 類,也不會觸發異常,ASP.NET 將基於名稱空間選擇其中一個(匹配專案的根名稱空間優先,否則使用第一個按字母排列的名稱空間中的類)。

Configure 方法

Configure 方法用於指定 ASP.NET 應用程式將如何響應每一個 HTTP 請求。簡單來說,你可以配置每個請求都接收相同的響應。然而,大多數現實世界應用程式需要比這多得多的功能。更復雜的管道配置可以封裝於 

中介軟體(middleware) 之中,並通過擴充套件方法新增到 IApplicationBuilder 上。

Configure 方法必須接受一個 IApplicationBuilder 引數。一些額外服務,比如 IHostingEnvironment 或 ILoggerFactory 也可以被指定,如果在它們可用情況下,這些服務將會被伺服器 注入 進來。在下例(源於預設的 Web 站點模板)中可見多個擴充套件方法被用於配置管道以支援 BrowserLink 、錯誤頁、靜態檔案、ASP.NET MVC 以及 Identity。

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    loggerFactory.AddConsole(Configuration.GetSection("Logging"));
    loggerFactory.AddDebug();

    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();//手工高亮
        app.UseDatabaseErrorPage();//手工高亮
        app.UseBrowserLink();//手工高亮
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");//手工高亮
    }

    app.UseStaticFiles();//手工高亮

    app.UseIdentity();//手工高亮

    // Add external authentication middleware below. To configure them please see http://go.microsoft.com/fwlink/?LinkID=532715

    app.UseMvc(routes =>//手工高亮
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

每個 Use 擴充套件方法都會把一個 中介軟體 加入請求管道。比如 UseMvc 擴充套件方法會把 路由中介軟體 加進請求管道,並把 MVC 配置為預設的處理器。

ConfigureServices 方法

你的 Startup 類能可選地包含一個 ConfigureServices 方法用來配置用於應用程式內的服務。ConfigureServices 方法是 Startup 類中的公開方法,通過引數獲取一個IServiceCollection 例項並可選地返回 IServiceProviderConfigureServices 需要在 Configure 之前被呼叫。這一點非常重要,這是因為像 ASP.NET MVC 中的某些功能,需要從 ConfigureServices 中請求某些服務,而這些服務需要在接入請求管道之前先被加入 ConfigureServices 中。

正如通過 Configure,推薦在 IServiceCollection 上使用擴充套件方法來包裝含有大量配置細節的 ConfigureServices 。你可在本例(使用了預設的 Web 站點模板)中看到幾個 Add[Something] 擴充套件方法被用於設定應用程式,以便能夠使用 Entity Framework、Identity 和 MVC:

public void ConfigureServices(IServiceCollection services)
{
    // Add framework services.
    services.AddDbContext<ApplicationDbContext>(options =>//手工高亮
        options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

    services.AddIdentity<ApplicationUser, IdentityRole>()//手工高亮
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

    services.AddMvc();//手工高亮

    // Add application services.
    services.AddTransient<IEmailSender, AuthMessageSender>();
    services.AddTransient<ISmsSender, AuthMessageSender>();
}

通過 依賴注入(dependency injection) 可將服務加入服務容器,使其在應用程式中可用。正如 Startup 類能將指定的依賴項作為其方法引數——而不是硬編碼(hard-coding)來例項化特定實現——對於中介軟體、MVC 控制器以及應用程式中的其它類來說都可以做到這一點。

ConfigureServices 方法同樣是可以增加配置選項類的地方(如上例中的 AppSettings),只要你想讓它在應用程式中生效。更多有關配置選項的資訊請閱讀Configuration

在啟動時服務可用

ASP.NET Core 在應用程式啟動期間提供了一些應用服務和物件。你可以非常簡單地使用這些服務,只需要在在 Startup 類的建構函式或是它的 Configure 與 ConfigureServices 方法中的一個包含合適的介面即可。下面定義了在 Startup 類中對每個方法可用的服務。框架服務和物件包括:

IApplicationBuilder
被用於構建應用程式的請求管道。只可以在 Startup 中的 Configure 方法裡使用。更多請閱讀 請求Features

IApplicationEnvironment
提供了訪問應用程式屬性,類似於ApplicationNameApplicationVersion 以及 ApplicationBasePath。可以在 Startup 的建構函式和 Configure 方法中使用。

IHostingEnvironment
提供了當前的 EnvironmentNameWebRootPath 以及 Web 根檔案提供者。可以在 Startup 的建構函式和 Configure 方法中使用。

ILoggerFactory
提供了建立日誌的機制。可以在 Startup 的建構函式或 Configure 方法中使用。更多請閱讀 Logging

IServiceCollection
當前容器中各服務的配置集合。只可在 ConfigureServices 方法中被使用,通過在該方法中配置可使服務在應用程式中可用。

看看 Startup 類中按它們被呼叫排序的每一個方法,下面的服務可被作為引數:
Startup Constructor - IApplicationEnvironment - IHostingEnvironment - ILoggerFactory

ConfigureServices - IServiceCollection

Configure - IApplicationBuilder - IApplicationEnvironment - IHostingEnvironment - ILoggerFactory

注意
儘管 ILoggerFactory 在建構函式中可用,但它通常在 Configure 方法中配置。具體可閱讀 Logging

擴充套件閱讀

返回目錄

相關推薦

ASP.NET Core 中文 原理1應用程式啟動

ASP.NET Core 為你的應用程式提供了處理每個請求的完整控制。Startup 類是應用程式的入口(entry point),這個類可以設定配置(configuration)並且將應用程式將要使用的服務連線起來。開發人員可以在 Startup 類中配置請求管道,該管道將用於處理應用程式的所有請求。 章

ASP.NET Core 中文 原理2中介軟體

章節: 什麼是中介軟體 中介軟體是用於組成應用程式管道來處理請求和響應的元件。管道內的每一個元件都可以選擇是否將請求交給下一個元件、並在管道中呼叫下一個元件之前和之後執行某些操作。請求委託被用來建立請求管道,請求委託處理每一個 HTTP 請求。 請求委託通過使用 IApplicationBuilder

ASP.NET Core 中文 原理6全球化與本地化

使用 ASP.NET Core 建立一個多語言版本的網站有助於你吸引到更多的使用者,ASP.NET Core 提供服務和中介軟體來支援本地化語言和文化。 國際化涉及 全球化 和 本地化。全球化是為了應用程式支援不同文化而設計的。全球化增加了對特定地理區域的語言文字的輸入、顯示和輸出的支援。 本地化是針對一個

ASP.NET Core 中文 原理11在多個環境中工作

ASP.NET Core 介紹了支援在多個環境中管理應用程式行為的改進,如開發(development),預演(staging)和生產(production)。環境變數用來指示應用程式正在執行的環境,允許應用程式適當地配置。 章節: 開發,預演,生產 ASP.NET Core 引用了一個特定的環境變數

ASP.NET Core 中文 原理4路由

路由是用來把請求對映到路由處理程式。應用程式一啟動就配置了路由,並且可以從URL中提取值用於處理請求。它還負責使用 ASP.NET 應用程式中定義的路由來生成連結。 這份文件涵蓋了初級的ASP.NET核心路由。對於 ASP.NET 核心 MVC 路由, 請檢視 Routing to Controller A

ASP.NET Core 中文 原理13管理應用程式狀態

在 ASP.NET Core 中,有多種途徑可以對應用程式的狀態進行管理,取決於檢索狀態的時機和方式。本文簡要介紹幾種可選的方式,並著重介紹為 ASP.NET Core 應用程式安裝並配置會話狀態支援。 應用程式狀態的可選方式 應用程式狀態 指的是用於描述應用程式當前狀況的任意資料。包括全域性的和使用者特

ASP.NET Core 中文 原理16.NET開放Web介面OWIN

ASP.NET Core 支援 OWIN(即 Open Web Server Interface for .NET 的首字母縮寫),OWIN的目標是用於解耦Web Server和Web Application。此外, OWIN為中介軟體定義了一個標準方法用來處理單個請求以及相關聯的響應。ASP.NET Co

ASP.NET Core 中文 原理17為你的伺服器選擇合適版本的.NET框架

ASP.NET Core基於 .NET Core 專案模型,它支援構建能夠執行在 Windows、Mac和 Linux 上的跨平臺應用程式。當您構建一個 .Net Core 專案的時候,您可以選擇一種 .NET框架來構建您的應用程式,.NET Framework (CLR)、 .NET Core (Core

ASP.NET Core 中文 MVC01ASP.NET Core MVC 概覽

ASP.NET Core MVC 是使用模型-檢視-控制器(Model-View-Controller)設計模式構建網頁應用與 API 的豐富的框架。 什麼是 MVC 模式? 模型-檢視-控制器(MVC)架構模式將一個應用區分為三部分主要元件:模型、檢視、與控制器。這種模式有助實現關注分離。使用這種模式,使

ASP.NET Core 中文 MVC4.6Areas區域

Areas 是 ASP.NET MVC 用來將相關功能組織成一組單獨名稱空間(路由)和資料夾結構(檢視)的功能。使用 Areas 建立層次結構的路由,是通過新增另一個路由引數 area 到 Controller 和 action。 Areas 提供了一種把大型 ASP.NET Core MVC Web 應用

ASP.NET Core 中文 測試5.2整合測試

整合測試確保應用程式的元件組裝在一起時正常工作。 ASP.NET Core支援使用單元測試框架和可用於處理沒有網路開銷請求的內建測試的網路主機整合測試。 章節: 整合測試介紹 整合測試驗證應用程式不同的部位是否正確地組裝在一起。不像單元測試,整合測試經常涉及到應用基礎設施,如資料庫,檔案系統,網路資源

ASP.NET Core 中文 MVC4.2控制器操作的路由

ASP.NET Core MVC 使用路由 中介軟體 來匹配傳入請求的 URL 並對映到具體的操作。路由通過啟動程式碼或者特性定義。路由描述 URL 路徑應該如何匹配到操作。路由也同樣用於生成響應中返回的 URL(用於連結)。 這篇文章將解釋 MVC 和路由之間的相互作用,以及典型的 MVC 應用程式如何使

ASP.NET Core 中文 MVC4.1Controllers, Actions 和 Action Results

Action 和 action result 是開發者使用 ASP.NET MVC 構建應用程式的基礎部分。 什麼是 Controller 在 ASP.NET MVC 中, 控制器( Controller  )用於定義和聚合操作(Action)的一個集合。操作( 或操作方法 )是控制器中處理入站請求的一個方

ASP.NET Core 中文 MVC2.3格式化響應資料

ASP.NET Core MVC 內建支援對相應資料(response data)的格式化,用來修正格式或生成客戶端指定的格式。 特定格式的操作結果 某些操作結果(Action result)的型別是指定的特定格式,比如 JsonResult 或 ContentResult。Action 可以返回格式化為

ASP.NET Core 中文 MVC4.4依賴注入和控制器

ASP.NET Core MVC 控制器應通過它們的構造器明確的請求它們的依賴關係。在某些情況下,單個控制器的操作可能需要一個服務,在控制器級別上的請求可能沒有意義。在這種情況下,你也可以選擇將服務作為 action 方法的引數。 章節: 依賴注入 依賴注入(Dependency injection,

ASP.NET Core 中文 MVC4.3過濾器

ASP.NET MVC 過濾器 可在執行管道的前後特定階段執行程式碼。過濾器可以配置為全域性有效、僅對控制器有效或是僅對 Action 有效。 過濾器如何工作? 不同的過濾器型別會在執行管道的不同階段執行,因此它們各自有一套適用場景。根據你實際要解決的問題以及在請求管道中執行的位置來選擇建立不同的過濾器。

ASP.NET Core 中文 MVC3.8檢視中的依賴注入

ASP.NET Core 支援在檢視中使用 依賴注入 。這將有助於提供檢視專用的服務,比如本地化或者僅用於填充檢視元素的資料。你應該儘量保持控制器和檢視間的關注點分離(separation of concerns)。你的檢視所顯示的大部分資料應該從控制器傳入。 章節: 一個簡單的示例 你可以使用 @i

ASP.NET Core 中文 MVC3.7 區域性檢視partial

ASP.NET Core MVC 支援區域性檢視,當你需要在多個不同檢視間重用同一個頁面部件時會顯得特別有用。 什麼是區域性檢視? 區域性檢視是在其它檢視中被渲染的檢視。區域性檢視執行後生成的 HTML 結果會被渲染到呼叫方檢視或父檢視中。跟檢視檔案一樣,區域性檢視檔案也使用 .cshtml 作為副檔名。

ASP.NET Core 中文 MVC4.5測試控制器邏輯

ASP.NET MVC 應用程式的控制器應當小巧並專注於使用者介面。涉及了非 UI 事務的大控制器更難於測試和維護。 章節: 為什麼要測試控制器 控制器是所有 ASP.NET Core MVC 應用程式的核心部分。因此,你應當確保它們的行為符合應用的預期。 自動化測試可以為你提供這樣的保障並能夠在進入生

ASP.NET Core 中文 MVC3.9檢視元件

章節: 介紹檢視元件 檢視元件是 ASP.NET Core MVC 中的新特性,與區域性檢視相似,但是它們更加的強大。檢視元件不使用模型繫結,只取決於呼叫它時所提供的資料。檢視元件有以下特點: 渲染一個塊,而不是整個響應 在控制器和檢視之間同樣包含了關注點分離和可測試性帶來的好處 可以擁有引數和業務邏