ASP.NET Core 運行原理剖析1:初始化WebApp模版並運行

之前兩篇文章簡析.NET Core 以及與 .NET Framework的關係和.NET Core的構成體系從總體上介紹.NET Core,接下來計劃用一個系列對ASP.NET Core的運行原理進行剖析 ...

ASP.NET Core 運行原理剖析1:初始化WebApp模版並運行

之前兩篇文章簡析.NET Core 以及與 .NET Framework的關係和.NET Core的構成體系從總體上介紹.NET Core,接下來計劃用一個系列對ASP.NET Core的運行原理進行剖析。

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

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

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

正式版的.NET Core已於今天發佈(2016年6月27日)，具體可看微軟 .NET Core 1.0 正式發佈下載

核心框架

ASP.NET Core 在 .NET Core 的基礎上發展，目前規劃的功能有：

ASP.NET Core MVC: ASP.NET Core MVC 提供了開發動態web站點的API，包括了WebPages 和 WebAPI ,最終可運行在IIS 或自托管(self-hosted)的伺服器中。
DependencyInjection: 包含了通用的依賴註入介面,用於在ASP.NET Core MVC中使用。
Entity Framework Core: 與之前版本的EntityFramework版本類似是一個輕量級的ORM框架，包括了Linq,POCO和Codefirst的支持。
ASP.NET Core Identity: 用於在ASP.NET Core web applications構建用戶許可權系統的框架，包括了membership、login等功能，同時也可以方便的擴展和自定義。

ASP.NET Core APP 創建與運行

一、安裝the .NET Core SDK for Windows(Linux、MAC)

以Windows為例，(下載地址),
安裝完成後可以用命令dotnet -v查看版本號。

C:\Users\stephen>dotnet -v
Telemetry is: Enabled
.NET Command Line Tools (1.0.0-preview1-002702)
Usage: dotnet [common-options] [command] [arguments]

二、命令行生成模版項目

開發一個webapp可以從零開始創建文件，也可以通過命令行生成一個空的項目模版，下麵的代碼用於從零開始創建模版。

mkdir aspnetcoreapp
cd aspnetcoreapp
dotnet new

依次執行命令後，便可在當前路徑下，生成模版。

模版包括以下三個文件：

project.json:

主掌項目的運行期的配置設置，包含項目的包參考 (Package References)、項目的基本設置、引導指令、包含或排除指定目錄、以及建造時的相關事件指令等。

Program.cs:

程式入口文件

project.lock.json:

與project.json相比，是project.json文件中引用包的完整引用列表。

三、修改project.json

project.json是用於定義項目需要依賴的資源，每個WebApp 需要一個hosting 程式(IIS、IISExpress等)，而此次使用Kestrel (什麼是kestrel?)，在project.json中加入對Kestrel的依賴代碼清單如下。

"dependencies": {
  "Microsoft.NETCore.App": {
    "type": "platform",
    "version": "1.0.0-rc2-3002702"
  },
  "Microsoft.AspNetCore.Server.Kestrel": "1.0.0-rc2-final"
},

四、下載依賴包部署網站

在WebApp部署時(dotnet restore)根據project.json的依賴文件,依靠nuget下載依賴包,完成對整個程式的restore。(類似於Nodejs的 npm restore)

在C:\Users\stephen\.nuget\packages可以看到nuget已經下載到本地的包，在開始部署前nuget是不會載入依賴包，下圖可看到目前nuget並沒有下載任何包。

nuget

然後執行命令

dotnet restore

可以看到，nuget已經自動將需要依賴包下載到本地

nuget

五、添加Startup.cs文件

對於一個ASP.NET Core 程式而言，Startup Class 是必須的。ASP.NET Core在程式啟動時會從assemblies中找到名字叫Startup的類，如果存在多個名為Startup的類，則會先找到項目根名稱空間下的Startup類。

在Startup必須定義Configure方法，而configureServices方法則是可選的，方法會在程式第一次啟動時被調用，類似傳統的ASP.NET MVC的路由和應用程式狀態均可在Startup中配置，也可以在此安裝所需中間件等等。Startup的詳細功能的對於startup.cs中的configure和configureServices方法會在後續文章中詳解。

在剛纔文件路徑下添加Startup.cs文件，並複製如下代碼:

using System;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;

namespace aspnetcoreapp
{
    public class Startup
    {
        public void Configure(IApplicationBuilder app)
        {
            app.Run(context =>
            {
                return context.Response.WriteAsync("Hello from ASP.NET Core!");
            });
        }
    }
}

六、Web Hosting 配置

在Program.cs文件中複製如下代碼，指定WebApp宿主程式為Kestrel:

using System;
using Microsoft.AspNetCore.Hosting;

namespace aspnetcoreapp
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseKestrel()
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }
    }
}