瞭解ASP.NET5 Web應用程序

時間 2019-12-08

標籤瞭解 asp.net5 asp web 應用程序欄目 ASP 简体版

原文原文鏈接

本文參考ASP.NET5 官方文檔 Understanding ASP.NET 5 Web Apps，加入了一些我的理解,理解不對的地方但願你們能指出，互相學習。css

ASP.NET 5 針對WEB編程引入了幾個新的基本概念，理解這些概念對快速開發WEB應用來講很重要。或許這些這些概念對你來講不是新的，可是對那些使用ASP.NET 和 Visual Studio 進行傳統的WEB應用開發的程序員來講，這些概念多是新的。html

本文主要內容包括:node

ASP.NET 項目結構程序員
Framework 運行時web
project.json 文件npm
global.json 文件編程
wwwroot 文件夾json
客戶端依賴管理gulp
服務端依賴管理安全
應用程序啓動

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 文件夾

在ASP.NET 的早期版本中，項目所在的文件夾就是WEB 應用程序的根目錄，url請求對應着具體的文件，如http://xxxx/default.aspx ，在後期的版本中，路由概念的加入使url 和具體文件分離。可是靜態文件的加載（js文件,css文件等）仍然基於它們的目錄結構。
這種基於文件的訪問方式存在不少問題，好比如何保護項目的敏感文件不被訪問（如：web.config，global.asax），以前通常是採用黑名單的方式保證一些特定的文件或者文件類型不被訪問，可是這種方式比白名單的方式安全性要低。 ASP.NET 5還解決了某些文件在測試環境和生產環境是不一樣版本的問題（如：web.config）。
ASP.NET 5 的wwwroot 就是 WEB應用運行時的目錄，一些靜態文件，像appsettings.json 沒有放在
裏邊，也就不用擔憂會被訪問到，所以也沒有必要建立特殊規則來阻止訪問敏感文件。 ASP.NET 5 採用白名單的方式，即只有在wwwroot文件夾中的文件才能夠經過Web請求訪問。wwwroot文件夾是默認的Web 應用所在的文件夾，若是要使用指定的文件夾，能夠在project.json 裏配置。

客戶端依賴管理

該依賴項文件夾裏包含兩個子文件夾：bower 和 NPM，這是兩個包管理器，他們負責管理獲取客戶端的依賴項。展開文件夾，能夠看到每一個工具目前管理的依賴項及其版本。

bower 和 NPM 的具體功能網上有不少介紹，這裏不作詳細描述。

服務器端依賴管理

在解決方案資源管理器的引用文件夾下詳細展現了項目的引用項。這應該是你們比較熟悉的。不一樣點是它引用了兩個目標框架：完整的 DNX 4.5.1和 DNX Core 5.0，每一個目標框架都有各自的引用關係，而且經過圖標能夠區分出來引用的是一個組件仍是一個NuGet 資源包或者是其它項目。這些依賴將在編譯的時候進行檢查，丟失的依賴項會從配置的NuGet包源（工具>NuGet包管理器>程序包管理器設置>程序包源）進行下載。

應用程序啓動

ASP.NET 5將程序分解爲各類模塊，這些模塊能夠按需單獨的添加到WEB應用程序裏邊。這使得程序更加精簡。若是你使用空模板建立一個 ASP.NET 5 應用，你會發現 Startup.cs 文件只有簡單的幾行代碼。默認的WEB項目裏 startup 類把 configuration, MVC, EF, Identity services, logging, routes等處理程序鏈接起來. 它提供了一個很好的例子展現如何配置使用你的ASP.NET應用程序。startup 類樣例裏邊包含三個部分：構造函數，ConfigureServices和 Configure
Configure 方法在ConfigureServices方法以後被調用，用於配置中間件。

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

咱們能夠在構造函數裏邊看到應用是如何處理配置文件的。Configuration 是 startup 類的一個屬性，配置信息能夠從各類來源(如JSON、XML或環境變量)來獲取，默認的模板中使用ConfigurationBuilder 經過appsettings.json 和環境變量信息來建立一個IConfiguration實例，您也能夠編寫本身的自定義configuration provider，可參考 Configuration。
ConfigureServices 方法被用來指定哪些服務被提供給應用程序使用。在默認的模板裏添加了3種服務： EF, Identity 和 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>();
}

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來配置處理程序。更多的信息，請參閱應用程序的啓動、配置和基本原理.