ASP.NET Core WebApi（01）项目建立

前言：前一段时间学习了ASP.NET Core，决定写个简单的项目，旨在消化所学内容，并记录过程中遇到的问题。本章是第一篇，内容为项目的建立

一、准备工作

安装Visual Studio时，默认会安装上.NET Core SDK；如果没有安装，需要到微软官方网站下载.NET Core SDK，保证对ASP.NET Core的支持，目前版本是.NET Core 3.1，如下图，下载安装即可：

二、新建项目

1、打开VS，选择ASP.NET Core Web应用程序，如下图，如果找不到可以进行简单的筛选：

2、我们给项目起个名字，我想实现简单的分层，所以把解决方案名称修改了一下，如下图：

3、选择.NET Core和对应的版本号，这里我们选择API，右边高级中“为HTTPS配置”把勾去掉，如下图：

4、项目建立成功，我们F5运行一下看看，界面出现的是一个天气预报的Json数组，这里我的浏览器安装了扩展，所以看上去结构比较清晰，如下图：

5、页面是怎么出现的呢？看一下项目结构，原来项目中有一个天气预报的类和控制器方法：

三、解决方案文件说明

1、csproj文件

双击项目名称，会出现了一个后缀为csproj的文件，该文件包含的是一些项目信息，包括使用的SDK，目标框架版本信息，包含的目录信息，如下图：

2、launchsettings.json

点开Properties，会发现launchsettings.json文件，这是一个程序运行配置文件。

内部对应了两个配置，一个是IIS Express的配置，使用该配置时，VS会调用IIS Express运行项目，我们知道IIS Express是IIS的一个“迷你”版(项目运行时右下角可见)，所以文件中还包括了一些IIS的设定；另一个是项目的配置，使用该配置时会使用dotnet run来运行程序，并默认使用Kestrel来替代传统的IIS，Kestrel支持跨平台，并且它性能更佳。

我们可以通过菜单栏中选择进行切换，或者右击项目选择属性后再调试选项页面中切换。

3、依赖项

依赖项中我们可以手动或使用NuGet来添加一些封装好的引用

4、appsetting.json与appsettings.Development.json

appsetting.json是应用程序配置文件，类似原先使用的WebConfig文件，里面默认对日志进行了一些配置。我们点开之后发现里面还有一个appsettings.Development.json文件，这个又是什么呢？

在实际的开发中，我们通常会配置多个环境，比如开发环境，生产环境以及模拟环境等，但是在不同的环境中，配置是不同的，比如数据库的连接，静态文件的是否压缩等等。为了满足这种需求，微软推出了这样的配置方式。

那么，它们的执行顺序是怎么样的呢？我们来看一下源码，系统会先加载appsetting.json，再加载目前设定的环境变量，比如appsettings.Development.json(在launchsettings.json中设置，可自定义)，再加载UserSecrets，再加载计算机系统的环境变量，最后加载命令行变量。所以如果在上面5个设置中都添加了相同的参数变量，那么后执行的会覆盖前面执行的。

5、Program

接下来我们来看一下Program.cs文件，它其实对应了一个控制台应用，系统运行后首先会进入Main方法。

来看一下具体的流程：

1、Main方法会调用下方的CreateWebHostBuilder静态方法；

2、CreateWebHostBuilder静态方法会调用Host对象的CreateDefaultBuilder静态方法，在此方法中会加载一些默认的服务，包括：①使用ASP.NET Core内置的Kestrel Web Server(支持跨平台)；②IIS集成(加载CLR运行时)；③Log(可以在不同的地方显示日志信息)；④IConfiguration接口(可以通过该接口获取项目的配置信息，即上面提到的5类配置信息)当然还有其他很多默认服务，如下图：

3、 CreateWebHostBuilder静态方法会返回一个IWebHostBuilder对象，该对象会通过UseStartUp实例化一个类加载整个Web应用的默认服务，系统默认使用的是StartUp类

6、Startup（重要）

最后我们来看一下Program中被调用的StartUp，它是系统默认的Web应用配置类。类的内部包括了其构造函数，ConfigurationServices方法和Configure方法。

1、构造函数：它获取了一个实现了IConfiguration接口的对象，Program中我们有提到IConfiguration接口默认会被加载，也就是说我们在这边就可以使用该对象获取配置信息。

2、ConfigurationServices：我们在这里进行服务的注册，前面有提到系统会加载一些默认的服务，其他系统默认实现好了的服务或者是我们自定义的服务，就需要我们自己在这里进行注册了。注册过之后我们就可以通过依赖注入的方式进行全局的使用。像在之前的.NET Framework中我们通过AutoFac或者Unity等第三方服务实现的IOC容器就可以在这里注册，但是ASP.NET Core已经内置了IOC容器，我们同样在这里注册就可以了。

3、Configure：我们在这里配置Http处理请求管道中间件，来响应ASP.NET Core程序的HTTP请求。另外需要注意的是中间件的添加顺序是十分重要的，比如异常处理中间件或验证中间件要放在比较靠前的位置，否则是无意义的。我们通常使用Use开头的方法进行注册中间件。

最后再来看下什么是中间件？中间件是应用程序管道中进行组装后，可以处理请求和响应的组件。它们会按照添加的顺序依次进行处理，处理完成后再依次进行返回。即前一个组件接受请求后，会将请求传递给下一个中间件，直至最后一个中间件处理完成后再逆序返回响应，如下图：

此外，每个中间件可以进行“短路”，举个例子，第2个中间件是验证中间件，发现请求的信息不满足验证要求，就会返回，不会再继续处理第3个中间件。

本人知识点有限，若文中有错误的地方请及时指正，方便大家更好的学习和交流。

本文参考了园中几位大佬的视频内容及图片，仅供学习和交流使用，视频地址如下：

solenovex，ASP.NET Core MVC 2.x 全面教程

solenovex，ASP.NET Core 3.x 入门视频

solenovex，使用 ASP.NET Core 3.x 构建 RESTful Web API

角落的白板报，《从零开始学ASP.NET Core与Entity Framework Core 》