ASP.NETCore学习记录(一)
ASP.NETCore学习记录(一)
0. ASP.NETCore 介绍
ASP.NETCore是一个新的开源和跨平台的框架，用于构建如Web应用、物联网（IoT)应用和移动后端应用等连接到互联网的基于云的现代应用程序。ASP.NET Core应用可运行于.NET Core和完整的.NET Framework之上。构建它的目的是为那些部署在云端或者内部运行的应用提 供一个优化的开发框架。它由最小开销的模块化的组件构成，因此在构建解决方案的同时可以 保持灵活性。我们可以在Windows、Mac和Linux上跨平台开发和运行自己的ASP.NET Core 应用。
ASP.NETCore 开源在 GitHub 上。ASP.NET Core有一些架构上的改变，这些改变使得它成为一个更为精简并且模块化的框架。ASP.NET Core不再基于System.Web.dll。当前它基于一系列颗粒化的，并且有良好构建的 NuGet包。这一特点能够让你通过仅仅包含需要的NuGet包的方法来优化你的应用。一个更小 的应用程序接口通过“只为你需要的功能付出”（pay-for-what-you-use)模型获得的好处包括: 可靠的安全性、简化服务、改进性能和减少成本。
通过ASP.NET Core可以获得的改进如下：
- 一个统一的方式用于构建Web UI和Web APIs。
- 集成现代的客户端开发框架和开发流程。
- 一个适用于云的，基于环境的配置系统。
- 内置的依赖注入。
- 新型的、轻量级的、模块化HTTP请求管道。
- 运行于IIS或者自宿主（self_host)于你自己的进程的能力。
- 基于支持真正的side-by-side应用程序版本化的.NET Core构建。
- 完全以NuGet包的形式发布。
- 新的用于简化现代Web开发的工具。
- 可以在Windows、Mac和Linux上构建和运行跨平台的ASP.NET应用。
- 开源并且重视社区。
1. ASP.NETCore 应用
使用VS 2017新建一个Web应用，打开VS 2017创建一个新的解决方案，在解决方案中新建一个项目，在添加新项目窗口中选择 .NET Core，选择ASP.NETCore Web应用程序，如下图所示：
这里的实例我们使用 Web Application (MVC) 框架版本为 .NET Core 2.1 如下图所示：
一个ASP.NET Core 应用其实就是在 Program 类的 Main方法调用 WebHost.CreateDefaultBuilder方法，创建了一个默认的Web应用程序宿主（Web服务器）。相比于.NET Core 1.0 在.NET Core 2.x 少了许多配置，新的方式已经隐藏了很多细节， 在WebHost.CreateDefaultBuilder这个函数内部帮助我们完成了大部分的配置工作（启用了Web服务器 UseKestrel、配置内容根目录 UseContentRoot等）。
在下面的代码中，Main方法创建了一个默认的Web服务器，并指定Startup类（UseStartup）的方法。下面会讲解更多关于 Startup 的内容。Build 和 Run 方法构建了用于宿主应用程序的 IWebHost，然后启动它来监听传入的HTTP请求。
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Logging;
namespace WebApplicationDome
{
public class Program
{
public static void Main(string[] args)
{
CreateWebHostBuilder(args).Build().Run();
}
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>();
}
}
2. 服务器
ASP.NET Core 托管模式并不直接监听请求，而是依赖于一个 HTTP Server 实现来转发请求到应用程序。这个被转发的请求会以一组 feature 接口的形式被包装，然后被应用程序组合到一个 HttpContext 中去。ASP.NET Core 包含了一个托管的跨平台Web服务器：Kestrel，它往往会 被运行在一个如 IIS 或者 Nginx 的生产 Web 服务器之后。
3. Startup.cs
WebHostBuilderExtensions 的 UseStartup 方法为你的应用指定了 Startup 类。
Startup类是应用程序的入口（entrypoint），这个类可以用来定义请求处理管道和配置应用需耍的服务。
Startup 类必须是公开的 (public)。
Startup类能够选择性地在构造函数中接受通过依赖注入提供的依赖项。
Startup类必须定义 Configure方法，可选择定义一个 ConfigureServices方法，这些方法将在应用程序启动时被调用：
public class Startup
{
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
}
}
在ASP.NETCore中，Startup类提供了应用程序的入口，而且在所有应用程序都有Startup类。可能会存在特定环境的启动类和方法，但无论如何，Startup 类都将被充当为应用程序的启动点。
1）. ConfigureServices方法
ConfigureServices 方法用于定义应用程序所使用的服务。通过依赖注入可将服务加入服务容器（IoC容器），使其在应用程序中可用。正如 Startup 类能将指定的依赖项作为其方法参数——而不足硬编码（hard-coding）来实例化特定实现，在应用程序中的其他类都可以做到这一点。通过在 IServiceCollection 上使用扩展方法来包装需要大量配置细节的 ConfigureServices。在下面的例子（使用了默认的Web应用程序MVC模板）中看到 ConfigureServices 方法中有个 AddMvc 的扩展方法被用于设罝应用程序能够使用MVC服务：
public void ConfigureServices(IServiceCollection services)
{
services.Configure<CookiePolicyOptions>(options =>
{
// This lambda determines whether user consent for non-essential cookies is needed for a given request.
options.CheckConsentNeeded = context => true;
options.MinimumSameSitePolicy = SameSiteMode.None;
});
services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}
2）. Configure方法
Configure方法用于指定ASP.NET应用程序将如何响应每一个HTTP请求。简单来说，你可以配置每个请求都接收相同的响应。然而，大多数实际的应用程序都需要比这更多的功能。更复杂的管道配置可以封装于中间件（middleware）中，并通过扩展方法添加到 lApplicationBuilder 上。Configure 方法必须接受一个 IApplicationBuilder 参数。一些额外服务，比如 IHostingEnvironment 或 ILoggerFactory 也可以被指定，并且在它们可用的情况下，这些服务将会被服务器注入进来。在下面的例子（来源于默认的Web应用程序MVC站点模板），多个扩展方法被用于配罝管道，以支持错误页、静态文件、ASP.NET MVC路由。
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Home/Error");
app.UseHsts();
}
app.UseHttpsRedirection(); // 添加HTTPS重定向中间件
app.UseStaticFiles(); // 添加静态文件中间件
app.UseCookiePolicy(); // 使用Cookie策略中间件
app.UseMvc(routes => // 使用MVC中间件
{
routes.MapRoute(
name: "default",
template: "{controller=Home}/{action=Index}/{id?}");
});
}
每个 Use 扩展方法都会把一个中间件加入请求管道中。例如，UseMvc扩展方法增加路由中间件请求管道，并配置MVC为默认处理程序。
在下一节中间件，将会介绍更多有关中间件的信息，包括使用 IApplicationBuilder 来定义请求管道，创建自己的自定义中间件。
3）. 在启动时服务可用
ASP.NETCore在应用程序启动期间提供了一些应用服务和对象。使用这些服务的方法非常简单，只要在 Startup 类的构造函数中包含合适的接口，或是在它的 Configure方法、ConfigureServices方法中包含合适的接口即可。下面定义了在Startup类中对每个方法可用的服务。框架服务和对象包括如下内容：
①. IApplicationBuilder
被用于构建应用程序的请求管道。只能在 Startup 中的 Configure方法里使用。
②. IApplicationEnvironment
提供了访问应用程序属性，类似于ApplicationNamc、ApplicationVersion以及 ApplicationBasePath。可以在Startup的构造函数和Configure方法中使用。
③. IHostingEnvironment
提供了当前的EnvironmentName、WebRootPath以及Web根文件提供者。可以在Startup的构造函数和Configure方法中使用。
④. LoggerFactory
提供了创建日志的机制。可以在 Startup的构造函数或 Configure 方法中使用，更多请阅读 Logging。
⑤. IServiceCollection
当前容器中各服务的配置集合。只能在 ConfigureServices 方法中使用。只有在 ConfigureServices方法中配罝后，此服务在应用程序中才变得可用。
看看Startup类中按它们被调用排序的每一个方法，下面的服务可作为参数：
- Startup构造函数： IApplicationEnvironment, IHostingEnvironment, ILoggerFactory
- ConfigureServiccs方法： IServiccCollcction
- Configure方法： IApplicationBuilder, IApplicationEnvironment, IHostingEnvironment, ILoggerFactory
4. 服务
服务是应用程序中用于通用调用的组件。服务通过依赖注入获取并使用。ASP.NET Core内置了一个简单的控制反转(IoC)容器，它默认支持构造器注入，并且可以方便地替换成你自己选用的 IoC 容器。由于它的松耦合特性，依赖注入(DI)使服务在整个应用中都可以使用。例如，Logging 在整个应用中都可用。
5. 内容根目录
内容根目录是应用程序所用到的所有内容的根路径，比如它的 views 和 web内容。默认情况下，内容根目录是与宿主应用的可执行程序的应用根目录相同：其他位罝可以通过 WebHostBuilder 来设置。
6. Web根目录
应用程序的 Web根目录是项目中类似于 CSS、JS和图片文件公开、静态的资源的目录。静态文件中间件将默认只读取Web根目录和其子目录中的文件。Web根目录默认为[content root]/wwwroot。（可以通过WebHostBuilder来指定另外一个地址）
7. 配置
ASP.NET Core使用了一个新的配置模型，用来处理简单的键值对。新的配置模型不是基于 System.Configuration 或者 web.config；相反，它足一个有序拉取数据的配置 providers。内置的构造提供支持多种不同的文件格式，如 XML、JSON、INI和用于支持基于环境的配置环境变量，也可以自己编写实现自定义的配罝providers。
8. 环境
ASP.NET Core 支持在多个环境中管理应用程序行为，如开发Development，预演staging和生产Production，是ASP.NET Core中的第一级概念，而且它可以使用环境变量来配置。
将在后面记录中详细介绍以上知识点。
参考资料
《ASP.NET Core 跨平台开发从入门到实践》
