ASP.NET Core3基础：01. 示例项目搭建与启动顺序

一、新建示例项目

可以通过dotnet cli和visual studio进行创建项目，这里使用vs进行新建

1. 这里选择ASP.NET Core Web应用程序

2. 这里选择API，并且把HTTPS的勾去掉，点击创建。选择API是以为默认已经配置好了一些设置，方便进行测试。

3. 为了方便学习，可以下载中文语言包，具体查看官方文档：https://docs.microsoft.com/zh-cn/dotnet/core/install/localized-intellisense

二、ASP.NET Core 3的启动执行顺序

首先看 ​Program.cs​ 文件，ASP.NET Core 3本质是一个控制台应用程序，Host是一个静态类，提供使用预配置默认值创建 ​IHostBuilder​实例的简便方法，​CreateDefaultBuilder​ 的参数提供了通过命令行注入配置的默认实现。​ConfigureWebHostDefaults 使用与配置默认值创建 ​IWebHostBuilder​ 类的实例。ConfigureWebHostDefaults 里面通过 ​UseStartup ​配置了​Startup​ 这个类作为启动的配置类。

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
namespace MyExample.DemoWebApi {
    public class Program {
        public static void Main(string[] args) {
            CreateHostBuilder(args).Build( ).Run( );
        }
        public static IHostBuilder CreateHostBuilder(string[] args) =>
            // 使用预配置默认值初始化 HostBuilder 类的新实例
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder => {
                    webBuilder.UseStartup<Startup>( );
                });
    }
}

接着看 ​Startup.cs​ 文件，在这里可以添加我们自己的配置。

构造方法中，注入了一个 ​IConfiguration​ 用于读取程序的配置信息，例如读取appsetting.json的配置信息，这里能用注入的方法是因为在 Program.cs 中已经默认为程序提供了一些默认的注入。

​ConfigureServices​ 可以用来配置自定的程序服务注入，例如：EFCore的仓储注入、应用程序的配置等。一般来说不会直接在这个类下面写，而是创建一个扩展方法。

​Configure ​用来配置应用程序的请求管道，API项目默认已经为程序添加了以下管道：

• ​app.UseDeveloperExceptionPage​：显示异常的信息（发布到生成环境时不应该启用这个）
• ​app.UseRouting​：配置应用程序的路由
• ​app.UseAuthorization​：配置认证信息
• ​app.UseEndpoints​：匹配路由的节点，这里配置了默认实现（RESTful格式）。也可以配置为controller/action模式：​endpoints.MapControllerRoute("default","{controller=Home}/{action=Index}/{id?}"); 。关于RESTful可以参考：http://www.ruanyifeng.com/blog/2011/09/restful.html

以上仅是很小一部分，ASP.NET Core 3有非常多的默认中间件供调用，我们也可以配置自己的中间件实现，实现自定义请求的控制。

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using System.Threading;
namespace MyExample.DemoWebApi {
    public class Startup {
        public Startup(IConfiguration configuration) {
            Configuration = configuration;
        }
        public IConfiguration Configuration { get; }
        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services) {
            services.AddControllers( );
        }
        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env) {
            if (env.IsDevelopment( )) {
                app.UseDeveloperExceptionPage( );
            }
            app.UseRouting( );
            app.UseAuthorization( );
            app.UseEndpoints(endpoints => {
                // 默认实现方式：RESTful
                endpoints.MapControllers( );
            });
        }
    }
}

在 ​Configure​ 方法中的中间件定义是有先后顺序区分的，默认是先定义的先执行。请求管道中的每个中间件组件负责调用管道中的下一个组件，或在适当情况下使链发生短路，官网的图：

ASP.NET Core 请求管道包含一系列请求委托，依次调用。 下图演示了这一概念。 沿黑色箭头执行。每个委托均可在下一个委托前后执行操作。 应尽早在管道中调用异常处理委托，这样它们就能捕获在管道的后期阶段发生的异常。

三、简单的请求

将项目启动后，请求 http://localhost:5000/weatherforecast 端口可能会不同，放回的结果（经过格式化）：

例子中的请求顺序可以通过控制台或者输出窗口查看

因为配置了 ​endpoints.MapControllers( ); ​，所以 http://localhost:5000/weatherforecast 会找到 ​Controller/​WeatherForecastController的​Get​方法，并返回数据。