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 》

猜你喜欢

转载自www.cnblogs.com/Jscroop/p/12819894.html
今日推荐