在 Visual Studio 2022 中,Web 开发人员的主要场景之一是使用 ASP.NET Core 创建 Web API。在 Visual Studio 2022 17.6 的最新预览版中,我们添加了一些更新,以便在开发 API 时更高效。在这篇文章中,我们将介绍一个从头开始的新的 API 开发的示例场景,并在此过程中指出新特性。
我们将在这篇文章中介绍的一些新特性包括:
* 带有集成客户端的 HTTP 编辑器
* API Endpoint 资源管理器
* 脚手架
* Entity Framework 工具
在这篇文章中,我们将展示从一个新项目开始开发一个完整的 Web API 的完整的端到端。下面是这篇文章的概要。
* 创建一个新的 API 项目
* 向项目中添加模型
* 使用脚手架生成 API
* 使用 API Endpoint 资源管理器
* 使用 HTTP 编辑器
开始
要在 Visual Studio 中开发 Web API,第一步是创建一个新项目。在 Visual Studio 2022 中,您可以使用“新建项目”对话框创建一个新项目。在这篇文章中,我们将要为一个虚构的外卖餐厅创建一个 ASP.NET Core Web API。按照教程,创建一个名为 MyRestaurantService 的项目,并在附加信息页面中选择以下选项。
在这个示例中,我们使用的是 Endpoint,而不是基于 Controller 的 API。API Endpoint 和基于 Controller 的 API 的步骤是相同的,只是适用场合不同。
既然已经创建了项目,我们要做的第一件事就是为我们想要通过 API 公开的对象添加一些模型类。我们将需要向项目添加以下类/枚举。在下表中,您将看到要创建的对象列表。
添加的文件要么是标准 POCO 类,要么是枚举。例如,Contact.cs:
namespace MyRestaurantApi; public class Contact { public int Id { get; set; } public string? Name { get; set; } public string? Email { get; set; } public string? Phone { get; set; } }