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

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

七、编译