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

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

1.引言

啟動(dòng)類默認(rèn)命名為Startup,它是在程序入口函數(shù)中為了構(gòu)造IWebHost時(shí)通過UseStartup<Startup>()指定的误墓。主要是定義了兩個(gè)方法ConfigureServiceConfigure方法领猾。應(yīng)用程序啟動(dòng)時(shí)根據(jù)UseStartup方法指定的Startup類或程序集用狱,借助StartupLoader進(jìn)行反射調(diào)用,以完成依賴服務(wù)注冊和中間件注冊,以構(gòu)造完整的HTTP請求管道已慢。

下面我們就結(jié)合MVC模板項(xiàng)目中的Startup類來探討下其簡單用法座掘。

2. 約定方法

我們知道啟動(dòng)類中主要包含了ConfigureServiceConfigure兩個(gè)方法递惋。

2.1. ConfigureService

該方法一般用于配置服務(wù)將服務(wù)注冊到依賴注入容器中,在Configure方法之前被調(diào)用溢陪。通過調(diào)用IServiceCollection的擴(kuò)展方法進(jìn)行服務(wù)注冊萍虽。擴(kuò)展方法的命名建議按照Add[MethodName]進(jìn)行約定,比如Mvc相關(guān)服務(wù)的注冊services.AddMvc()形真。

除此之外杉编,我們還可以在此方法中替換ASP.NET Core默認(rèn)內(nèi)置的依賴注入框架。比如我們使用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

該方法用于定義應(yīng)用程序如何響應(yīng)每個(gè)HTTP請求卵迂,以及配置HTTP流水線中的中間件。

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

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

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

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

因?yàn)樵摲椒ㄓ糜谂渲谜麄€(gè)http請求管道宝当,所以中間件的注冊要注意順序。同樣胆萧,在配置中間件時(shí)庆揩,我們同樣建議遵循Use[Middleware]的命名約定,比如啟用Mvc中間件app.UseMvc跌穗。

3. 可用服務(wù)

從上節(jié)我們就已經(jīng)知道订晌,ASP.NET Core在調(diào)用之前已經(jīng)默認(rèn)注入了以下幾個(gè)可用服務(wù):

  • IConfiguration:用于讀取應(yīng)用程序配置。
  • IServiceCollection:可以理解為ASP.NET Core內(nèi)置的依賴注入容器蚌吸。
  • IApplicationBuilder:用于構(gòu)建應(yīng)用程序的請求管道锈拨。
  • IHostingEnvironment :提供了當(dāng)前應(yīng)用程序的運(yùn)行的宿主環(huán)境配置信息。

除此之外羹唠,我們還可以使用已經(jīng)注入的IServiceProvider奕枢、ILoggerFactoryILogger佩微、IApplicationLifetime等可用服務(wù)缝彬。這些預(yù)置服務(wù)可以注入到Startup類的構(gòu)造函數(shù)或Configure方中。就像這樣:

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

ConfigureServices只支持一個(gè)參數(shù)IServiceCollection喊衫,因?yàn)樗械囊蕾嚩伎梢酝ㄟ^IServiceCollection獲取跌造,所以沒有必要通過方法再注入其他服務(wù),可以直接通過以下方式解析依賴的服務(wù):

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

4. 定義多個(gè)啟動(dòng)類

我們看下Configure方法我們發(fā)現(xiàn)族购,通過IHostingEnvironment服務(wù)壳贪,我們可以獲取當(dāng)前應(yīng)用程序的運(yùn)行環(huán)境。代碼中為開發(fā)環(huán)境啟用了異常詳情頁面寝杖、數(shù)據(jù)庫錯(cuò)誤頁面和Brower Link(支持啟動(dòng)多個(gè)web瀏覽器违施,并可同步刷新,一般用于跨瀏覽器測試)瑟幕,以方便我們開發(fā)調(diào)試磕蒲。

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

ASP.NET Core默認(rèn)內(nèi)置了三種環(huán)境變量:Development留潦、 Staging、Production辣往。我們可以為每一種環(huán)境定義一個(gè)啟動(dòng)類兔院,命名為Startup[Environment]即可。在啟動(dòng)時(shí)通過指定啟動(dòng)類所在的程序集名稱即可根據(jù)launchSettings中的配置的ASPNETCORE_ENVIRONMENT自動(dòng)加載對應(yīng)的啟動(dòng)類站削。

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseStartup(Assembly.GetExecutingAssembly().FullName)
        .Build();
示例
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末坊萝,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子许起,更是在濱河造成了極大的恐慌十偶,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,104評(píng)論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件园细,死亡現(xiàn)場離奇詭異惦积,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)猛频,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,816評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門狮崩,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人鹿寻,你說我怎么就攤上這事厉亏。” “怎么了烈和?”我有些...
    開封第一講書人閱讀 168,697評(píng)論 0 360
  • 文/不壞的土叔 我叫張陵,是天一觀的道長皿淋。 經(jīng)常有香客問我招刹,道長,這世上最難降的妖魔是什么窝趣? 我笑而不...
    開封第一講書人閱讀 59,836評(píng)論 1 298
  • 正文 為了忘掉前任疯暑,我火速辦了婚禮,結(jié)果婚禮上哑舒,老公的妹妹穿的比我還像新娘妇拯。我一直安慰自己,他們只是感情好洗鸵,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,851評(píng)論 6 397
  • 文/花漫 我一把揭開白布越锈。 她就那樣靜靜地躺著,像睡著了一般膘滨。 火紅的嫁衣襯著肌膚如雪甘凭。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,441評(píng)論 1 310
  • 那天火邓,我揣著相機(jī)與錄音丹弱,去河邊找鬼德撬。 笑死,一個(gè)胖子當(dāng)著我的面吹牛躲胳,可吹牛的內(nèi)容都是我干的蜓洪。 我是一名探鬼主播,決...
    沈念sama閱讀 40,992評(píng)論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼坯苹,長吁一口氣:“原來是場噩夢啊……” “哼隆檀!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起北滥,我...
    開封第一講書人閱讀 39,899評(píng)論 0 276
  • 序言:老撾萬榮一對情侶失蹤刚操,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后再芋,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體菊霜,經(jīng)...
    沈念sama閱讀 46,457評(píng)論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,529評(píng)論 3 341
  • 正文 我和宋清朗相戀三年济赎,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了鉴逞。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,664評(píng)論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡司训,死狀恐怖构捡,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情壳猜,我是刑警寧澤勾徽,帶...
    沈念sama閱讀 36,346評(píng)論 5 350
  • 正文 年R本政府宣布,位于F島的核電站统扳,受9級(jí)特大地震影響喘帚,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜咒钟,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,025評(píng)論 3 334
  • 文/蒙蒙 一吹由、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧朱嘴,春花似錦倾鲫、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,511評(píng)論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至壤追,卻和暖如春玫荣,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背大诸。 一陣腳步聲響...
    開封第一講書人閱讀 33,611評(píng)論 1 272
  • 我被黑心中介騙來泰國打工捅厂, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留贯卦,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 49,081評(píng)論 3 377
  • 正文 我出身青樓焙贷,卻偏偏與公主長得像撵割,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個(gè)殘疾皇子辙芍,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,675評(píng)論 2 359

推薦閱讀更多精彩內(nèi)容