使用者:小朱/沙盒/ASP.NET Core

ASP.NET Core
開發者Microsoft
預覽版本1.0.0-rc1(2015年11月18日 (2015-11-18)
程式語言C#
類型Web應用程式MVC
許可協議Apache License 2.0
網站ASP.NET vNextGitHub ASP.NET Core Home


ASP.NET Core 是新一代的 ASP.NET,早期稱為 ASP.NET vNext,並且在推出初期命名為 ASP.NET 5,但隨著 .NET Core 的成熟,以及 ASP.NET 5 的命名會使得外界將它視為 ASP.NET 的升級版,但它其實是新一代從由開始打造的 ASP.NET 核心功能,因此微軟宣佈將它改為與 .NET Core 同步的名稱[1],即 ASP.NET Core。

ASP.NET Core 可運行於 Windows 平台以及非 Windows 平台,如 Mac OSX 以及 Ubuntu Linux 作業系統,是 Microsoft 第一個具有跨平台能力的 Web 開發框架。

微軟在一開始開發時就將 ASP.NET Core 開源,因此它也是開源專案的一員,由 .NET 基金會 (.NET Foundation) 所管理。

開發歷程

ASP.NET vNext 最早是在2014年5月被提出[2],當時是以專案代號 K (Project K) 命名,包含工具與執行期平台都以 K 來命名,其名稱為 KRE (K Runtime Environment) 如:

  • KLR (K Language Runtime): Project K 的執行期平台。
  • KVM (K Version Manager): Project K 的版本管理員。
  • KPM (K Package Manager): Project K 的套件管理員,類似於 node.js 的 npm (Node.js Package Manager)。
  • K (K Loader): Project K 的程式啟動器。

KRE 在 2014 年度時曾經一度在版本戳記上出現 RC 的字眼,但隨後 ASP.NET Core 開發團隊發出了一份新的 Roadmap,公布後續的版本計畫 [3]

到了 Build 2015 時,微軟將專案 K 重新命名,改稱為 .NET 執行環境 (.NET Execution Environment),簡稱 DNX,其工具也開始進行更名:

  • DNVM (.NET Version Manager): DNX 的版本管理員。
  • DNU (.NET Package Manager): DNX 的工具,可支援建造,還原與管理封裝等。
  • DNX (.NET Loader): DNX 的程式啟動器。

後續到了 ASP.NET Core RC1 時,.NET Core 已經發展成熟,並且也具有自己的工具 .NET Core CLI (dotnet.exe),此時微軟決定將 DNX 和 .NET Core CLI 合併,並且預期在 ASP.NET Core 1 RC2 時完成。

核心功能

ASP.NET Core 核心設計上是採用 Open Web Interface for .NET (OWIN) [4] 為概念發展,OWIN 在概念上就強調以程式碼來定義系統功能,並一度在 ASP.NET MVC 5 列入其功能之一[5],後續的 Web API 與 SignalR 也使用了 OWIN,但並沒有引起太多開發人員的重視,其主因還是因為 Visual Studio 簡化了太多元件間參考定義的工作,若是要回歸由原始碼作業,反而會讓開發人員無法適應。但隨著微軟確定將 ASP.NET Core 開發為可跨平台的核心架構時,其專案參考系統也由 Visual Studio 為主的加入參考對話盒轉向到以 project.json (.NET Core / ASP.NET Core 的專案組態檔) 為主,使得開發人員不能再以 GUI 介面來加入元件參考,只能利用編輯 project.json 的方式加入,這時由程式碼加入功能的作法才慢慢的被開發人員所接受,雖然這在 Mac 以及 Linux 環境是再平常不過的事。

由程式碼決定功能

ASP.NET Core 廣泛應用了 .NET 的擴充方法 (Extension Method),將 ASP.NET Core 的功能模組 (ASP.NET Core 的術語是 Middleware) 以擴充方法的方式附掛在 IApplicationBuilder 介面上,以 Use 開頭的方法為命名標準,所有應用程式所需要的功能都必須添加在 Startup 類別內,DNX Runtime 在啟動時會搜尋應用程式內的 Startup 物件,並喚起它內部的特定方法 (如 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");
    }

    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?}");
    });
}

內建的相依注入

ASP.NET Core 核心內建了基本的相依注入 (Dependency Injection) 能力,這意味著 ASP.NET Core 應用程式具有更強的擴充能力,連帶的如 ASP.NET MVC 6 (ASP.NET Core 的 Web 開發框架) 也受惠於 ASP.NET Core 的相依注入功能,可在 Controller 內直接注入介面物件。ASP.NET Core 內提供了兩種相依注入功能,一種是管線式相依注入 (ASP.NET Core 稱它為 Framework-Provided Services),另一種是由系統註冊的相依注入,由開發人員利用 ASP.NET Core 提供的 IServiceCollection 介面內的方法註冊需要的介面與服務,再由程式中取用。

IServiceCollection 支援四種類型的服務相依注入[6]

  1. Transient: 每次要求時都建立,不論是否在同一範圍。
  2. Scoped: 只在一個要求範圍內建立一次,在當下的範圍內等同於 Singleton。
  3. Singleton: 只會提供一個物件的執行個體,但生成是由系統做。
  4. Instance: 在應用程式的生命週期內只會提供一個物件的執行個體,但生成是由開發人員負責。

ASP.NET Core 也不限只能用 ASP.NET Core 本身的相依注入功能,若是有喜歡或慣用的相依注入元件 (如 AutofacStructureMap 等),也可以用它們取代內建的相依注入功能[7]

多樣的代管 (Hosting) 方式

ASP.NET Core 支援自我代管 (Self-hosting) 以及 Web Server 代管 (Web Server-hosting) 的功能 [8],早期 ASP.NET Core 有延續以 IIS 為主要代管服務的設計 (當時的代號為 Helios),但是到了 ASP.NET Core Beta 8 時,微軟宣佈將以 Kestrel Server 為主要的代管伺服器 [9],Kestrel Server 是以 libuv 為基礎開發的 Web Server 代管行程 (Hosting Process),藉由 libuv 的協助,Kestrel Server 可跨平台,也可適用於 IIS,微軟也為了 IIS 使用 Kestrel Server 而發展了 IIS Platform Handler,讓 IIS 可直接將 HTTP 的要求直接轉送給 Kestrel Server。

ASP.NET Core 也另外提供了一個 Web Listener,由 HTTP.SYS (IIS 的 HTTP 核心聆聽器) 聆聽訊息的代理行程,作為在 IIS 以外的代管行程,以支援自我代管能力。

專案系統

ASP.NET Core 不再使用 .csproj 的專案管理方式,而是改用以目錄為主的專案管理,原本的 Web.config 也不再存在,取而代之的是 project.json,以及作為組態設定的 appsettings.json 檔案,這兩個檔案都是JSON格式。雖然在 Visual Studio 的 ASP.NET Core 的專案範本中,Web.config 仍然存在,但它的存在只是為了要在 IIS 中附掛上 HTTP Platform Handler 而已。

project.json

project.json 主掌專案的執行期的組態設定,包含專案的套件參考 (Package References)、專案的基本設定、啟動指令、包含或排除指定目錄、以及建造時的相關事件指令等。

下列JSON為 project.json 的範例[10]

{
  "version": "0.1-alpha-*",
  "compilationOptions": {
    "warningsAsErrors": true
  },
  "dependencies": {
    "Microsoft.Bcl.Immutable": "1.1.18-beta-*",
    "Microsoft.AspNet.ConfigurationModel": "0.1-alpha-*",
    "Microsoft.AspNet.DependencyInjection": "0.1-alpha-*",
    "Microsoft.AspNet.Logging": "0.1-alpha-*",
    "System.Data.Common": "0.1-alpha-*"
  },
  "code": ["**/*.cs", "/Shared/*.cs"],
  "frameworks": {
    "dnx451": {
      "frameworkAssemblies": {
        "System.Runtime": "",
        "System.Collections": ""
      }
    },
    "dnxcore50": {
      "dependencies": {
        "System.Collections": "4.0.0.0",
        "System.Collections.Concurrent": "4.0.0.0",
        "System.ComponentModel": "4.0.0.0",
        "System.Console": "4.0.0.0",
        "System.Diagnostics.Contracts": "4.0.0.0",
        "System.Diagnostics.Debug": "4.0.10.0",
        "System.Globalization": "4.0.10.0",
        "System.Linq": "4.0.0.0",
        "System.Linq.Expressions": "4.0.0.0",
        "System.Linq.Queryable": "4.0.0.0",
        "System.Reflection": "4.0.10.0",
        "System.Reflection.Extensions": "4.0.0.0",
        "System.Resources.ResourceManager": "4.0.0.0",
        "System.Runtime": "4.0.20.0",
        "System.Runtime.Extensions": "4.0.10.0",
        "System.Threading": "4.0.0.0",
        "System.Threading.Tasks": "4.0.10.0"
      }
    }
  }
}

appsettings.json

appsettings.json 是用來替代 Web.config 內的 <appSettings /> 與 <connectionStrings /> 兩個開發人員最常用的組態區段,其內容示例如下:

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=aspnet5-WebApplication1-8479b9ce-7b8f-4402-9616-0843bc642f09;Trusted_Connection=True;MultipleActiveResultSets=true"
    }
  },
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Verbose",
      "System": "Information",
      "Microsoft": "Information"
    }
  }
}

不過 appsettings.json 不像 project.json 是由 DNX 自動讀取,appsettings.json 或是後續加入的組態檔都是屬於功能之一,依照 ASP.NET Core 由程式碼決定功能的特性,開發人員需要加入下列程式才能讓 appsettings.json 生效。

public Startup(IHostingEnvironment env)
{
    // Set up configuration providers.
    var builder = new ConfigurationBuilder()
        .AddJsonFile("appsettings.json")
        .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);

    Configuration = builder.Build();
}

套件相依管理

ASP.NET Core 的套件相依管理 (Package Dependency Management) 由 project.json 負責,project.json 內的 dependencies 區段以及 frameworks 區段負責管理對套件的相依,以及對特定 Framework 版本內組件的相依。

dependencies 內的套件是以 "套件代碼": "版本" 的格式設定,例如 "Microsoft.AspNet.Mvc": "1.0.0-rc1-final" 表示參考 Microsoft.AspNet.Mvc 套件的 v1.0.0-rc1-final 版本。套件與版本資訊是用NuGet所提供,和以往要以加入參考的方式加入對特定組件的相依性有很大的不同,而這也是 .NET Core/ASP.NET Core 的特色之一,不必再安裝大包的 .NET Framework,只要使用 DNU 的 restore 指令,就能還原所參照的相依套件。

  "dependencies": {
    "Microsoft.Bcl.Immutable": "1.1.18-beta-*",
    "Microsoft.AspNet.ConfigurationModel": "0.1-alpha-*",
    "Microsoft.AspNet.DependencyInjection": "0.1-alpha-*",
    "Microsoft.AspNet.Logging": "0.1-alpha-*",
    "System.Data.Common": "0.1-alpha-*"
  }

frameworks 則是定義了特定系統環境內所相依的特定組件與其版本,在此定義的組件必須事先就安裝在電腦內才能取用,與 dependencies 會還原套件不同。開發人員可以給定一個字串來代表特定環境 (例如dnx45表示 DNX on .NET 4.5、dnxcore5 表示 DNX on .NET Core 5),然後在裡面指定特定的組件與其版本。

  "frameworks": {
    "net451": { },
    "dotnet5.4": {
      "dependencies": {
        "Microsoft.CSharp": "4.0.1-beta-23516",
        "System.Collections": "4.0.11-beta-23516",
        "System.Linq": "4.0.1-beta-23516",
        "System.Runtime": "4.0.21-beta-23516",
        "System.Threading": "4.0.11-beta-23516"
      }
    }
  }

開發框架

ASP.NET Core 以 .NET Core 的基礎發展,其目前規劃的功能有:

  1. ASP.NET MVC 6: 目前欽定的 Web 應用程式開發框架。
  2. ASP.NET SignalR 3: 新一代的長時輪詢 (Long-Time Polling) 訊息通訊基礎建設,計畫在 ASP.NET Core 1.0.0 釋出後才會繼續進行開發。
  3. Entity Framework Core: 下一代的 ADO.NET Entity Framework,採用 .NET Core 並重新設計,為欽定的 ORM 資料存取技術。

版本歷程

版本歷程
日期 版本
2014/05/12 ASP.NET 5 初登場 [11]
2014/07/06 ASP.NET 5 Alpha2 [12]
2014/08/17 ASP.NET 5 Alpha3 [13]
2014/10/07 ASP.NET 5 Alpha4 [14]
2014/11/12 ASP.NET 5 Beta1 [15]
2015/01/14 ASP.NET 5 Beta2 [16]
2015/03/13 ASP.NET 5 Beta3 [17]
2015/05/01 ASP.NET 5 Beta4 [18]
2015/06/30 ASP.NET 5 Beta5 [19]
2015/07/27 ASP.NET 5 Beta6 [20]
2015/09/02 ASP.NET 5 Beta7 [21]
2015/10/15 ASP.NET 5 Beta8 [22]
2015/11/19 ASP.NET 5 RC1 [23]
2016/01/19 ASP.NET 5 更名為 ASP.NET Core [24]

參考

  1. ^ ASP.NET 5 is dead – Introducing ASP.NET Core 1.0 and .NET Core 1.0
  2. ^ Introducing ASP.NET vNext
  3. ^ ASP.NET Core 1.0 Schedule and Roadmap
  4. ^ OWIN
  5. ^ Understanding OWIN Forms authentication in MVC 5
  6. ^ Dependency Injection in ASP.NET vNext
  7. ^ ASP.NET Core Dependency Injection
  8. ^ ASP.NET Core Servers
  9. ^ Announcing Availability of ASP.NET 5 Beta8
  10. ^ Project.json file
  11. ^ Introducting ASP.NET vNext
  12. ^ [1]
  13. ^ [2]
  14. ^ [3]
  15. ^ [4]
  16. ^ [5]
  17. ^ [6]
  18. ^ [7]
  19. ^ ASP.NET 5 Beta5 Now Available
  20. ^ Announcing Availability of ASP.NET 5 beta6
  21. ^ Announcing Availability of ASP.NET 5 Beta7
  22. ^ Announcing Availability of ASP.NET 5 Beta8
  23. ^ [8]
  24. ^ ASP.NET 5 is dead – Introducing ASP.NET Core 1.0 and .NET Core 1.0