如何入门并详细介绍Asp.Net Core WebAPI的使用技巧？

在Asp.Net Core 上面由于现在前后端分离已经是趋势，所以asp.net core MVC用的没有那么多，主要以WebApi作为学习目标。 一、创建一个WebApi项目 我使用的是VS2022, .Net 7版本。 在创建界面有几项配置： 配置Https 启用Docker 使用控制器 启用OpenAPI支持 不使用顶级语句 其中配置Https 是WebApi是否使用https协议，启用docker是配置服务是否docker部署支持。我们这边作为学习就先不管docker了。 然后下面还有三个配置，第一个是说是否使用控制器，如果使用接口服务放在Controllers文件夹下统一管理并且相关路由规则不一样。 第二个启用OpenAPI支持，如果启用OpenAPI说的是swagger支持，也就是说.net 自动集成了swagger。 第三个不使用顶级语句，如果勾选后则程序的Program类和Main方法完整。 那么我们看下上面配置是什么意思，第二个swagger支持我们就不管了默认开启。我建两个项目AspNetCoreWebAPI_1、AspNetCoreWebAPI_2，AspNetCoreWebAPI_1我们勾选上【使用控制器】、【不使用顶级语句】。AspNetCoreWebAPI_2项目这两项都不选。 先看下项目目录结构 不同在于AspNetCoreWebAPI_1项目多了Controllers文件夹和一个WeatherForecast类，WeatherForecast类是示例接口中有使用。 我们再对比一下 Program类 可以看到在AspNetCoreWebAPI_1项目中Program类和Main方法完整，因为要使用Controller的原因，所以依赖注入了Controller服务。并且使用了MapControllers注册路由。 在AspNetCoreWebAPI_2项目中没有只有Main方法内的代码，这就是顶级语句。然后由于我们还使用了最小API,就是不使用Controller方式注册和配置路由，直接在代码中自己注册接口和实现接口处理的代理方法。 按照以前asp.net习惯和项目清晰度维护性我们一般是使用Controller的方式，并且不使用顶级语句。 而最小 API，是创建具有最小依赖项的 HTTP API。 它非常适合于需要在 ASP.NET Core 中仅包括最少文件、功能和依赖项的微服务和应用。 另外还有一个appsetting.json配置文件，这部分内容也在前面已经介绍过,欢迎了解：.net 温故知新：【8】.NET 中的配置从xml转向json { "Logging": { "LogLevel": { "Default": "Information", "Microsoft.AspNetCore": "Warning" } }, "AllowedHosts": "*" } 二、WebApi运行 我们调试项目AspNetCoreWebAPI_1，此时会启动一个服务在后端，同时启动浏览器访问该站点的swagger，该swagger用于调我们调试webapi接口。 我们点击示例接口WeatherForecast，访问接口会返回json格式数据。响应的headers里面可以看到后端运行的服务器是Kestrel,和我们以前.net framework不一样的事需要借助IIS作为服务器。现在的Kestrel是包含在程序中的，这个Kestrel 以后再讨论。 三、WeatherForecastController WeatherForecastController是在创建项目后默认生成的一个示例Controller。在该Controller中我们可以看到几个重点项。