1. 启动类
在asp.net5当中,Startup类提供应用程序的入口,对所有应用程序是必须的。争对特定环境的配置的starup class和方法也是有可能的, 但是,不管怎样, 一个Startup类作为整个应用程序的入口。ASP.NET在主要的程序集当中寻找Startup的类名, 你可以用 Hosting:Application 配置键申明一个不同的程序集去掉Starup类,不管这个类是定义成公共的还是其它的, ASP.NET将加载它只要它符号命名规范。如果有多个Startup类,不会引发异常, ASP.NET会选择一个它命名空间的(符号当前工程根命名空间的优先,否则按字母表的排序的命名空间来用)。
Starup类可选地在构造函数当中通过DI接受依赖. 通常,应用程序的配置是有Startup构造函数当中定义的。另外Startup类当中也会定义Configure方法,也可以可选地定义ConfigureServices方法,他们会被调用在应用程序启动的时候。
2. 配置方法
Configure方法用来指明ASP.NET应用程序怎么回复一个单独的请求。最简单的,你可以配置每个请求返回同一个回复。然而,真实的应用程序要复杂得多,很多复杂的管道可以封装在middleware里面,可以用IApplicationBuilder的扩展方法添加。
你的Configure方法必须接受一个IApplicationBuilder的参数。另外还有IHostingEnvironment和ILoggerFactory。这些服务会随着程序的启动而被注入,下面是一个默认的站点的模板,你可以看到几个扩展的方法被用来支持BrowserLink, error pages, static files, ASP.NET MVC和Identity.
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
loggerFactory.AddConsole(Configuration.GetSection("Logging"));
logggerFactory.AddDebug();
if(env.IsDevelopment())
{
app.UserBrowserLink();
app.UseDeveloperExceptionPage();
app.UseDatabaseErrorPage();
}
else
{
app.UseExceptionHandler("/Home/Error");
}
app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear());
app.UseStaticFiles();
app.UseIdentity();
app.UseMvc(routes => { routes.MapRout( name="default", template: "{controller=Home}/{action=Index}/{id?}"); });
}
the UseMvc扩展方法被定义在BuilderExtensions里面, 它的首要职责是确保MVC被做为一个服务添加进来,并且设置了路由。
你可以用IApplicationBuilder去定义你自己的中间件。
3. ConfigureServices方法
你的Startup类可选地包含一个ConfigureServices方法,用来配置你的应用程序需要的服务。它带一个IServiceCollection参数,返回一个IServiceProvider, ConfigureServices在Configure之前调用。这很重要,因为一些功能比如MVC,要使它工作正常,需要特定的服务的添加在ConfigureService当中。
和Configure一样,服务的添加也是由IServiceCollection的扩展函数来添加的。例如下面的例子:
public void ConfigureServices(IServiceCollection services)
{
services.AddEntityFramework().AddSqlServer().AddDbContext<ApplicationDbContext>(options =>
options.UseSqlServer(Configuration["Data:DefaultConnection:ConnectionString"]));
services.AddIdentity<ApplicationUser, IdentityRole>().AddEntityFrameworkStores<ApplicationDbContext>().AddDefaultTokenProviders();
services.AddMvc();
services.AddTransient<IEmailSender, AuthMessageSender>();
services.AddTransient<ISmsSender, AuthMessageSender>();
}
增加的服务通过DI在应用的时候注入,像Startup一样,它里面方法的参数的具体实现也都是由容器注入的,同样的你的中间件,MVC控制器和其它的类也一样会注入。
配置类也在ConfigureServices方法当中添加,如:AppSettings.
4. 在Startup里面已知的服务
你可以在Startup构造函数或者Configure或者ConfigureServices方法当用应用接口来注册你自己的服务。下面是默认用到的一些接口:
IApplicationBuilder
这个用来创建应用程序的请求的管道,在Startup类的Configure方法当中用到
IApplicationEnvironment
提供用于访问应用程序的属性,如ApplicationName, ApplicationVersion, 和ApplicationBasePath, 在Startup的构造函数和Configure函数里都可用到。
IHostingEnvironment
提供如当前的EnvironmentName, WebRootPath, 和 web root file provider.
ILoggerFactory
提供创建日志的机制, 在Startup构造和Configure里用到。
IServiceCollection
当前窗口配置的服务的集合,在Startup的ConfigureServices方法当中用到。
下面是应用这些接口的顺序:
Startup构造函数:IApplicationEnvironment, IHostingEnvironment, ILoggerFactory
ConfigureServices : IServiceCollection
Configure: IApplicationBuilder, IApplicationEnvironment, IHostingEnvironment - ILoggerFactory