简介
在近些年中，随着 web 应用的快速发展，快速开发高性能的轻量级 WebApi 已经成为了开发人员的需求。.NET 6 轻量级 WebApi 框架 FastEndpoints 就是一个能够满足这一需求的利器。
FastEndpoints 是由 .NET 团队开发的一款基于 ASP.NET Core 的框架。它提供了一种简化开发流程的方式，使得开发人员能够更加专注于业务逻辑的实现，而不必在繁琐的配置上浪费太多时间。
在本篇博客中，我们将介绍如何入门这个令人兴奋的框架，并通过一些示例展示其强大的功能和特点。
安装 FastEndpoints
要使用 FastEndpoints，首先需要安装 .NET 6 SDK。 .NET 6 是一个全新的、开源的、跨平台的开发框架，具有许多令人兴奋的新功能和改进。
安装完成 .NET 6 后，我们可以使用以下命令来安装 FastEndpoints:
dotnet new -i FastEndpoints.WebApi.Template
创建一个快速的 WebApi
接下来，我们将使用 FastEndpoints 创建一个简单的 WebApi。
首先，打开命令行界面，并进入一个合适的目录。
然后，输入以下命令来创建一个新的 FastEndpoints WebApi 项目:
dotnet new fast-endpoints-webapi -n MyApi
这将在当前目录下创建一个名为 "MyApi" 的新文件夹，并在其中生成一个基本的 FastEndpoints WebApi 项目结构。
现在，我们可以进入项目文件夹并启动项目:
cd MyApi
dotnet run
此时，我们的 WebApi 就已经启动起来了。
添加一个简单的端点
在 FastEndpoints 中，我们使用 Endpoint 属性来定义一个端点。一个端点可以被看作一个处理特定请求的逻辑单元。
在 app.settings.json 文件中，我们可以定义一个或多个端点。例如，我们可以添加以下内容：
{
"Endpoints": [
{
"Method": "GET",
"Path": "/api/hello",
"Handler": "MyApi.Handlers.HelloHandler, MyApi"
}
]
}
上述配置定义了一个 GET 请求的 /api/hello 端点，并且将其处理逻辑委托给 HelloHandler 类的 HandleAsync 方法。
public class HelloHandler
{
public Task<IActionResult> HandleAsync(HttpRequest request)
{
return Task.FromResult<IActionResult>(new OkResult("Hello, world!"));
}
}
现在，我们可以向 /api/hello 发起 GET 请求，并且应该能够得到一个成功的响应，内容为 "Hello, world!"。
启用 Swagger
FastEndpoints 还提供了 Swagger 导出功能，用于生成强大的 API 文档。
为了启用 Swagger，我们需要在 app.settings.json 中添加以下配置：
{
"Swagger": {
"Enabled": true,
"EndpointPath": "/api/swagger",
"Title": "MyApi"
}
}
然后，在浏览器中访问 http://localhost:<port>/api/swagger，即可查看生成的 Swagger 文档。
总结
通过本文，我们已经了解了如何入门使用 .NET 6 轻量级 WebApi 框架 FastEndpoints。我们学习了如何安装和创建一个简单的 FastEndpoints WebApi，并且添加了一个简单的端点。此外，我们还看到了如何启用 Swagger，以生成强大的 API 文档。
FastEndpoints 提供了许多其他功能和特性，如路由、请求验证等，可以帮助我们开发高性能的 WebApi。我希望这篇博客能够帮助您快速上手并了解 FastEndpoints。
参考资源
本文来自极简博客，作者：冬日暖阳，转载请注明原文链接：.NET 6 轻量级 WebApi 框架 FastEndpoints 入门
