ASP.NET Core 1.0基础之应用启动

来源https://docs.asp.net/en/latest/fundamentals/startup.html

ASP.NET 5 使得应用对每个http请求有完整的控制权。Startup类是程序的入口，用来设置配置以及wire up一个用程序所使用的服务。开发者也是通过Startup类来配置应用程序的请求管道。

Startup类##

Startup是程序入口，是必须的。而且也可以提供基于环境配置的Startup类和方法,详见。ASP.NET通过在主程序集中搜索Startup命名的类来找到入口。你也可以指定Hosting:Application configuration key来使用一个不同的程序集。Startup类是否带public是没有关系的，即使有多个Startup类，也不会触发异常，ASP.NET会基于命名空间来选择一个（先基于项目根命名空间来选择，然后在基于命名空间的字母顺序来选择）。

Startup类可以在构造器中注入依赖，一般情况下应用是通过Startup类的构造器来配置详见。Startup类必须定义个Configure方法，ConfigureServices方法是可选的，他们会在应用启动时调用。

Configure方法##

Configure方法指定了应用对每个http请求的响应。最简单的情况，你可以配置每个请求收到同样的响应。但是实际项目是比较负复杂的，因此你可以使用封装好的中间件来通过IApplicationBuilder的扩展方法类配置。

Configure方法必须接收参数IApplicationBuilder，额外的服务如IHostingEnvironment和ILoggerFactory也可以添加到Configure方法的参数中，可以被注入进来。如下默认web模板，通过IApplicationBuilder扩展方法来配置服务BrowserLink, error pages, static files, ASP.NET MVC, and Identity。

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

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

    app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear());

    app.UseStaticFiles();

    app.UseIdentity();

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

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

你可以通过源码来查看扩展方法。例如UseMvc是定义在BuilderExtensions中的。它的主要责任是确保MVC是被添加((in ConfigureServices)的和配置MVC路由的的。

在Middleware 对与中间件可以了解更多以及使用IApplicationBuilder来配置请求管道。

ConfigureServices方法##

ConfigureServices方法是可选的，可以配置应用所使用的服务。ConfigureServices 是公共方法，参数是IServiceCollection，可选的返回IServiceProvider。这个ConfigureServices 方法在Configure之前调用。这很重要，因为一些特性如ASP.NET MVC需要先在ConfigureServices中配置，然后才能被加入到http请求管道中。

如Configure方法一样，推荐的做啊是，将需要配置的一些特性添加到IServiceCollection的扩展方法中(it is recommended that features that require substantial setup within ConfigureServices be wrapped up in extension methods on IServiceCollection)。在默认的web模板中，你可以看到有几个Add[Something]扩展方法来配置来自EF和Identiy以及MVC的服务。

public void ConfigureServices(IServiceCollection services)
{
    // Add framework services.
    services.AddEntityFramework()
        .AddSqlServer()
        .AddDbContext<ApplicationDbContext>(options =>
            options.UseSqlServer(Configuration["Data:DefaultConnection:ConnectionString"]));

    services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

    services.AddMvc();

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

通过依赖注入，将服务添加到服务容器中，使得在应用中可用。Startup 类可以指定方法参数的所需依赖，而不是硬编码一个具体实现，你的中间件，mvc controller和其他类也是如此。

ConfigureServices中你也的加入配置选项类，如AppSettings，然后应用中即可用，详见Configuration。

Startup类中的可用服务##

ASP.NET 5 在Startup类中提供了一些应用服务和对象。可以通过把合适的接口放进Startup的构造器参数里或者它的Configure或ConfigureServices方法的参数里，这些服务即可用的。Startup类中的每个方法的可用服务如下。framework服务和对象包括

• IApplicationBuilder 用来构建http请求管道，仅仅在Startup类中的Configure方法中可用，更多详见Request Features。
• IApplicationEnvironment 提供应用属性，如ApplicationName, ApplicationVersion, and ApplicationBasePath. 在Startup类构造器和Configure方法可用。
• IHostingEnvironment Provides the current EnvironmentName, WebRootPath, and web root file provider. Available to the Startup constructor and Configure method.
• ILoggerFactory 提供创建日志的机制，在构造器和Congigure方法中可用。详见Logging。
• IServiceCollection 容器中当前配置的服务集合，只在ConfigureServices中可用，来配置应用中可用的服务。

Startup类中方法调用顺序如下，以及他们可用的服务。

Startup Constructor - IApplicationEnvironment - IHostingEnvironment - ILoggerFactory

ConfigureServices - IServiceCollection

Configure - IApplicationBuilder - IApplicationEnvironment - IHostingEnvironment - ILoggerFactory

尽管ILoggerFactory在构造器中可用，但是一般配置在Configure方法中。详见Logging。