ASP.NET Core 知多少(2):啟動類

ASP.NET Core知多少系列:總體介紹及目錄

1.引言

啟動類默認命名為Startup,它是在程序入口函數(shù)中為了構造IWebHost時通過UseStartup<Startup>()指定的。主要是定義了兩個方法ConfigureServiceConfigure方法。應用程序啟動時根據(jù)UseStartup方法指定的Startup類或程序集,借助StartupLoader進行反射調用,以完成依賴服務注冊和中間件注冊,以構造完整的HTTP請求管道。

下面我們就結合MVC模板項目中的Startup類來探討下其簡單用法。

2. 約定方法

我們知道啟動類中主要包含了ConfigureServiceConfigure兩個方法。

2.1. ConfigureService

該方法一般用于配置服務將服務注冊到依賴注入容器中,在Configure方法之前被調用。通過調用IServiceCollection的擴展方法進行服務注冊。擴展方法的命名建議按照Add[MethodName]進行約定,比如Mvc相關服務的注冊services.AddMvc()

除此之外,我們還可以在此方法中替換ASP.NET Core默認內置的依賴注入框架。比如我們使用Castle Windsor替換:

  1. 安裝Castle.Windsor.MsDependencyInjection NuGet包;
  2. 修改方法返回值類型為IServiceProvider
  3. 替換依賴容器:
public IServiceProvider ConfigureServices(IServiceCollection services)
{
    services.AddMvc();

    //Add Castle Windsor DI
    var ioContainer = new WindsorContainer();

    return WindsorRegistrationHelper.CreateServiceProvider(ioContainer, services);
}

2.2. Configure

該方法用于定義應用程序如何響應每個HTTP請求,以及配置HTTP流水線中的中間件。

public void  Configure(IApplicationBuilder app)   
{  
    app.UseMvc();  //使用MVC框架去處理用戶請求
    //添加一個終端中間件委托到應用程序請求管道
    app.Run( context => {  
        return  context.Response.WriteAsync("Hello ASP.NET Core!");  
    });  
} 

該方法接受IApplicationBuilder作為參數(shù),同時可以接受一些可選參數(shù),如IHostingEnvironmentILoggerFactory。而且,在ConfigureServices方法中注冊的其他服務,也可以直接在該方法中通過參數(shù)直接注入使用,比如:

public void ConfigureServices(IServiceCollection services)
{
    services.AddScoped<ITestService, TestService>();
}

public void Configure(IApplicationBuilder app,ITestService testService)
{
    testService.Test();
}

因為該方法用于配置整個http請求管道,所以中間件的注冊要注意順序。同樣,在配置中間件時,我們同樣建議遵循Use[Middleware]的命名約定,比如啟用Mvc中間件app.UseMvc

3. 可用服務

從上節(jié)我們就已經知道,ASP.NET Core在調用之前已經默認注入了以下幾個可用服務:

  • IConfiguration:用于讀取應用程序配置。
  • IServiceCollection:可以理解為ASP.NET Core內置的依賴注入容器。
  • IApplicationBuilder:用于構建應用程序的請求管道。
  • IHostingEnvironment :提供了當前應用程序的運行的宿主環(huán)境配置信息。

除此之外,我們還可以使用已經注入的IServiceProviderILoggerFactoryILoggerIApplicationLifetime等可用服務。這些預置服務可以注入到Startup類的構造函數(shù)或Configure方中。就像這樣:

public void Configure(IApplicationBuilder app, IHostingEnvironment env,
      ILoggerFactory loggerFactory)
{
      loggerFactory.AddDebug();
}

ConfigureServices只支持一個參數(shù)IServiceCollection,因為所有的依賴都可以通過IServiceCollection獲取,所以沒有必要通過方法再注入其他服務,可以直接通過以下方式解析依賴的服務:

public void ConfigureServices(IServiceCollection services)
{
    var serveiceProvider = services.BuildServiceProvider();
    var logger =serveiceProvider.GetService<ILogger>();
    //....
}

4. 定義多個啟動類

我們看下Configure方法我們發(fā)現(xiàn),通過IHostingEnvironment服務,我們可以獲取當前應用程序的運行環(huán)境。代碼中為開發(fā)環(huán)境啟用了異常詳情頁面、數(shù)據(jù)庫錯誤頁面和Brower Link(支持啟動多個web瀏覽器,并可同步刷新,一般用于跨瀏覽器測試),以方便我們開發(fā)調試。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseBrowserLink();
        app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
    }
    //...
}

ASP.NET Core默認內置了三種環(huán)境變量:Development、 Staging、Production。我們可以為每一種環(huán)境定義一個啟動類,命名為Startup[Environment]即可。在啟動時通過指定啟動類所在的程序集名稱即可根據(jù)launchSettings中的配置的ASPNETCORE_ENVIRONMENT自動加載對應的啟動類。

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseStartup(Assembly.GetExecutingAssembly().FullName)
        .Build();
示例
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,908評論 6 541
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,324評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,018評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,675評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,417評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,783評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,779評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,960評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 49,522評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,267評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,471評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,009評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,698評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,099評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,386評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,204評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,436評論 2 378

推薦閱讀更多精彩內容