了解ASP.NET5 Web应用程序结构

ASP.NET 5 针对WEB编程引入了几个新的基本概念，理解这些概念对快速开发WEB应用来说很重要。或许这些这些概念对你来说不是新的，但是对那些使用ASP.NET 和 Visual Studio 进行传统的WEB应用开发的程序员来说，这些概念可能是新的。

本文主要内容包括:

• ASP.NET 项目结构

• Framework 运行时

• project.json 文件

• global.json 文件

• wwwroot 文件夹

• 客户端依赖管理

• 服务端依赖管理

• 应用程序启动

ASP.NET 项目结构

跟之前的ASP.NET解决方案相比，ASP.NET 5 多了一个 Solution Items 文件夹，里边有一个 global.json 文件，而 WEB 项目被放在一个 src 文件夹中。新的结构里有一个特殊的 

文件夹，并增加了 

这样一个节点。

打开项目的根目录，发现增加了若干个新文件：  bower.json, appsettings.json, gulpfile.js, package.json, project.json 和 Startup.cs 等。

同时，细心的童鞋会发现  global.asax, packages.config, web.config 这些文件都不见了。在 ASP.NET之前的版本中这些文件保存了大量的应用程序配置信息。但在ASP.NET5，这些信息和逻辑已经被重构到了更小，更集中的文件里。

运行时目标框架

ASP.NET 5 可在两种运行时环境中工作：传统的.NET Framework 和新的 .NET Core，默认情况下，应用程序将使用 .NET Framework 的完整版本运行。但我们也可以选择使用 .NET Core 版本。

你可以在项目上 右键>属性 来查看当前项目使用的运行时。

.NET Core--- 是 .NET Framework 一个子集，是一个新的，模块化的（利用NuGet），跨平台的更小体积的运行时。使用 .NET Core 你可以为你的每一个应用程序部署其专有的.NET 运行时，也就是说你的应用程序将以部署的运行时版本运行，而不是以主机操作系统上安装的运行时版本运行。一个应用程序的运行时的版本可以和其他应用程序的运行时版本不同并且可以并行运行。如果有需要你可以更新某个应用程序的运行时，但不会影响其他的应用程序。这将使得应用程序部署和架构更新变得更加简单，而且较少影响运行在系统上的其他应用程序。

.NET Framework--- 目前.NET Core的API较之完整的.NET Framework还有很多的不足，因此大多数传统的应用程序在ASP.NET 5 下只能使用完整版本的 .NET Framework运行，原因就是它们依赖的一些组件或类库在.NET Core 中还没有。 使用 .NET Framework 现有的应用程序和库将继续在运行时工作而不需要任何更改。

project.json 文件

这是 ASP.NET 5 新增的一个文件，它描述了项目的基本信息，依赖关系等。

 {   "userSecretsId": "aspnet5-FeatureVote-bd1ba2ae-0e4f-4e48-8ffc-fe223c1dc3cd",   "version": "1.0.0-*",   "compilationOptions": {     "emitEntryPoint": true   },    "dependencies": {     "Microsoft.ApplicationInsights.AspNet": "1.0.0-rc1",     "Microsoft.AspNet.Diagnostics": "1.0.0-rc1-final",     "Microsoft.AspNet.IISPlatformHandler": "1.0.0-rc1-final",     "Microsoft.AspNet.Mvc": "6.0.0-rc1-final",     "Microsoft.AspNet.Mvc.TagHelpers": "6.0.0-rc1-final",     "Microsoft.AspNet.Server.Kestrel": "1.0.0-rc1-final",     "Microsoft.AspNet.StaticFiles": "1.0.0-rc1-final",     "Microsoft.AspNet.Tooling.Razor": "1.0.0-rc1-final",     "Microsoft.Extensions.Configuration": "1.0.0-rc1-final",     "Microsoft.Extensions.Configuration.FileProviderExtensions" : "1.0.0-rc1-final",     "Microsoft.Extensions.Configuration.Json": "1.0.0-rc1-final",     "Microsoft.Extensions.Logging": "1.0.0-rc1-final",     "Microsoft.Extensions.Logging.Console": "1.0.0-rc1-final",     "Microsoft.Extensions.Logging.Debug": "1.0.0-rc1-final",     "Microsoft.VisualStudio.Web.BrowserLink.Loader": "14.0.0-rc1-final"   },    "commands": {     "web": "Microsoft.AspNet.Server.Kestrel --server.urls=http://localhost:5000"   },    "frameworks": {     "dnx461": { },     "dnxcore50": { }   },    "exclude": [     "wwwroot",     "node_modules"   ],   "publishExclude": [     "**.user",     "**.vspscc"   ],   "scripts": {     "prepublish": [ "npm install", "bower install", "gulp clean", "gulp min" ]   } } 

• userSecretsId 是应用程序的一个唯一ID，好像是和加密存储数据有关，具体还不了解。

• version 描述版本信息。

• compilationOptions 里边存放应用程序的编译选项，如 emitEntryPoint 用来告诉编译器这是一个应用程序还是一个类库,如果是一个应用程序，则项目代码里便必须要有 public static void Main() 方法（见Startup.cs 里边的 public static void Main(string[] args) => WebApplication.Run<Startup>(args); ）。

• 另外你还可以指定有关该项目的其他信息，如作者（authors ）和说明（description）等。

• dependencies 描述了项目的依赖关系，依赖项可以是 NuGet 包也可以是其它项目，依赖项版本可以具体制定，也可以使用通配符，使用通配符的时候ikeyi指定大版本，在小版本更新的时候会自动获取最新的小版本（有点像nodenode的包）。

• commands ASP.NET 5 支持很多命令行工具，该节点配置可以在命令行中运行的命令（例如，启动一个网站或运行测试）。

• frameworks 该部分指定编译使用的目标框架和一些依赖关系。-exclude 用于标记在编译时排除的部分。

• publishExclude 用于标记在发布网站时排除的部分。

• scripts 描述自动化构建时的脚本。

global.json 文件

这个文件用来存放解决方案的总体配置信息，默认包含两个配置节： projects 和  sdk

 {   "projects": [ "src", "test" ],   "sdk": {     "version": "1.0.0-rc1-update1"   } } 

• projects，指定在哪个文件夹里存放项目的源码

• sdk，指定Visual Studio打开解决方案时将使用的DNX（.Net Execution Environment）的版本。它在这里设置，而不是在project.json，是为了避免出现一个解决方案中的不同项目使用不同版本的SDK的情况。

wwwroot 文件夹

客户端依赖管理

该依赖项文件夹里包含两个子文件夹： bower 和  NPM ，这是两个包管理器，他们负责管理获取客户端的依赖项。 展开文件夹，可以看到每个工具目前管理的依赖项及其版本。

bower 和 NPM 的具体功能网上有很多介绍，这里不做详细描述。

服务器端依赖管理

在解决方案资源管理器的引用文件夹下详细展示了项目的引用项。这应该是大家比较熟悉的。不同点是它引用了两个目标框架：完整的 DNX 4.5.1和 DNX Core 5.0，每个目标框架都有各自的引用关系，并且通过图标可以区分出来引用的是一个组件还是一个NuGet 资源包或者是其它项目。这些依赖将在编译的时候进行检查，丢失的依赖项会从配置的NuGet包源（工具>NuGet包管理器>程序包管理器设置>程序包源）进行下载。

应用程序启动

 public Startup(IHostingEnvironment env) {     // Set up configuration sources.     var builder = new ConfigurationBuilder()         .AddJsonFile("appsettings.json")         .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);      if (env.IsDevelopment())     {         // For more details on using the user secret store see http://go.microsoft.com/fwlink/?LinkID=532709         builder.AddUserSecrets();     }      builder.AddEnvironmentVariables();     Configuration = builder.Build(); } 

 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>(); } 

Configure 方法在 ConfigureServices 之后被运行时调用，在示例项目中， Configure 调用控制台来做日志。为开环境添加了几个有用的功能，添加了静态文件、身份和MVC路由的支持，注意，只在ConfigureServices 中添加身份 和 MVC 还不够，它们还需要通过调用 Configure 在请求管道中配置。

 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");          // For more details on creating database during deployment see http://go.microsoft.com/fwlink/?LinkID=615859         try         {             using (var serviceScope = app.ApplicationServices.GetRequiredService<IServiceScopeFactory>()                 .CreateScope())             {                 serviceScope.ServiceProvider.GetService<ApplicationDbContext>()                      .Database.Migrate();             }         }         catch { }     }      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?}");     }); } 

你能看到，配置哪些服务是可用的，以及如何配置请求管道这些都完全是由 Startup 类来完成，而不是使用 HTTP 模块和通过web.config来配置处理程序。更多的信息，请参阅 应用程序的启动 、 配置 和 基本原理 .